bootstack 0.1.0a10__tar.gz → 0.1.0a12__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a10
+Version: 0.1.0a12
 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
@@ -63,11 +63,13 @@ bootstack gives engineers, data scientists, and hobbyists everything to build a
 polished desktop interface and package it into a standalone executable —
 declarative, reactive, and batteries-included, all in pure Python.
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-light.png">
   <img alt="bootstack hero demo" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-light.png">
 </picture>
+</p>
 
 ## Why bootstack?
 
@@ -75,14 +77,14 @@ Most Python desktop frameworks make you fight the framework. bootstack gets out
 
 - **30% less code** — the declarative, context-manager layout eliminates geometry calls, explicit parenting, and most of the wiring boilerplate
 - **Reads like Python** — nested `with` blocks mirror your UI structure; the code hierarchy *is* the layout
-- **Modern layout system** — `HStack`, `VStack`, and `Grid` containers handle spacing, alignment, and fill automatically; CSS conventions (`gap`, `padding`, `margin`, `fill`, `anchor`) without writing CSS
+- **Modern layout system** — `Row`, `Column`, and `Grid` containers handle spacing, alignment, and growth automatically; a screen-axis vocabulary (`gap`, `padding`, `margin`, `horizontal`, `vertical`, `grow`) without writing CSS
 - **60+ widgets out of the box** — primitives through full composites: tables, trees, calendars, date pickers, gauges, sliders, and more — including a full `CodeEditor` with syntax highlighting, line numbers, bracket matching, smart indent, and search; no external editor dependency required
 - **Reactive signals** — observable state that flows between widgets; bind once, update everywhere
 - **Event and stream pipelines** — compose, filter, debounce, and throttle UI events with a chainable stream API
-- **Built-in icons** — the full Bootstrap Icons catalog, theme-aware and DPI-scaled, bundled with the framework
+- **Built-in icons** — the full Bootstrap Icons catalog, theme-aware and recolorable, bundled with the framework
 - **Built-in localization** — 23 language catalogs, locale-aware number/date/time formatting, runtime language switching
 - **Semantic styling** — `accent="primary"`, `variant="outline"` — no hard-coded colors; looks right across every theme automatically
-- **8 paired light/dark themes** — with a runtime switcher and a custom-theme API
+- **10 paired light/dark themes** — popular dev color schemes plus Bootstrap, with a runtime switcher and a custom-theme API
 - **Forms and validation** — field-level validators, inline error messages, and a `FormDialog` for quick modal forms
 - **DataSource abstraction** — one interface over SQLite, in-memory, and file backends with filtering, sorting, pagination, and CRUD
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
@@ -108,11 +110,13 @@ The widget gallery is a single-window tour of everything bootstack ships — eve
 bootstack gallery
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-light.png">
   <img alt="bootstack widget gallery" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-light.png">
 </picture>
+</p>
 
 ## Quick Start
 
@@ -128,24 +132,26 @@ with bs.App(title="Hello", padding=16, gap=16) as app:
 app.run()
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
   <img alt="bootstack quick start example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
 </picture>
+</p>
 
-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
 
 shell = bs.AppShell(title="My App", size=(1000, 650))
 
-with shell.add_page("home", text="Home", icon="house"):
-    bs.Label("Welcome!")
-
-with shell.add_page("docs", text="Documents", icon="file-earmark-text"):
-    bs.Label("Your documents.")
+with shell.page_nav() as nav:
+    with nav.add_page("home", text="Home", icon="house"):
+        bs.Label("Welcome!")
+    with nav.add_page("docs", text="Documents", icon="file-earmark-text"):
+        bs.Label("Your documents.")
 
 shell.run()
 ```
@@ -154,11 +160,11 @@ shell.run()
 
 ### Layout containers
 
-`VStack`, `HStack`, and `Grid` let you describe a layout once instead of repeating geometry calls on each child:
+`Column`, `Row`, and `Grid` let you describe a layout once instead of repeating geometry calls on each child:
 
 ```python
 with bs.App(title="Sign In") as app:
-    with bs.Grid(columns=["auto", 1], gap=(12, 6), sticky_items="ew", padding=16):
+    with bs.Grid(columns=["auto", 1], gap=(12, 6), horizontal_items="stretch", padding=16):
         bs.Label("Name:")
         bs.TextField(placeholder="Full name")
         bs.Label("Email:")
@@ -170,11 +176,13 @@ with bs.App(title="Sign In") as app:
 app.run()
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-light.png">
   <img alt="bootstack layout containers example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-light.png">
 </picture>
+</p>
 
 ### Semantic styling
 
@@ -186,11 +194,13 @@ bs.Button("Cancel", accent="secondary", variant="outline")
 bs.Label("Heading", font="heading-lg")
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-light.png">
   <img alt="bootstack semantic styling example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-light.png">
 </picture>
+</p>
 
 ### Signals (optional)
 
@@ -207,17 +217,17 @@ app.run()
 
 ## Features
 
-- **Application scaffolding** — `App` for blank windows, `AppShell` for command-bar + sidebar + page-stack apps, undecorated windows with custom chrome
+- **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, `Workbench` for two-tier workspace apps, undecorated windows with custom chrome
 - **60+ themed widgets** — primitives plus higher-level composites (DataTable, Tree, ListView, Calendar, DateField, Form, Gauge, ToggleGroup, PageStack, Carousel, Tooltip, and more)
 - **Dialogs and messages** — `alert()` / `confirm()` / `ask_*()` prompts and `FormDialog` / `FontDialog` / `FilterDialog`, plus non-blocking `toast()`, `Notification`, and `Snackbar` surfaces
-- **Layout containers** — `VStack`, `HStack`, and `Grid` for declarative layouts; `Card`, `GroupBox`, `ScrollView`, `SplitView`, `Accordion`, `Expander`
+- **Layout containers** — `Column`, `Row`, `Grid`, and `Spacer` for declarative layouts; `Card`, `GroupBox`, `ScrollView`, `SplitView`, `Accordion`, `Divider`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost), consistent across widgets
-- **Built-in themes** — paired light/dark variants (amber, aurora, bootstrap, classic, docs, forest, ocean, rose) with runtime theme switching and a custom-theme API
+- **Built-in themes** — 10 paired light/dark variants (bootstrap, catppuccin, dracula, everforest, gruvbox, nord, one, pydata, solarized, tokyo-night) with runtime theme switching and a custom-theme API
 - **Reactive signals** — observable state with subscribe/set, integrates with widgets via `signal=` / `textsignal=`
 - **Forms & validation** — `Form` with built-in field-level validators and inline error messages
 - **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV/TSV/Excel export
 - **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
-- **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring, DPI scaling, and caching
+- **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring and caching
 - **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows
 - **CLI (`bootstack`)** — project scaffolding, run, add components, theme/i18n setup, doctor, build/package
 
@@ -225,13 +235,13 @@ app.run()
 
 | Category | Widgets |
 |----------|---------|
-| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, CommandBar |
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar, ThemeToggle |
 | **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 |
+| **Layout** | Column, Row, Grid, Spacer, Card, GroupBox, SplitView, ScrollView, Accordion, Divider |
+| **Navigation** | AppShell, Workbench, Window, StatusBar, Tabs, PageStack |
 | **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
 | **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
 | **Forms** | Form, with field-level validation |
@@ -243,14 +253,15 @@ bootstack ships with an optional CLI for scaffolding, running, and packaging app
 ```bash
 bootstack gallery                           # Launch the interactive widget gallery
 bootstack icons                             # Browse the built-in icon catalog
+bootstack appicon                           # Design an app icon and export it
 bootstack start MyApp                       # Create a new project (basic template)
 bootstack start MyApp --template appshell   # ...or with sidebar navigation
 bootstack run                               # Run the app defined in the project config
 bootstack add page Dashboard                # Add a new page (appshell)
 bootstack add view Settings                 # Add a new view (basic)
 bootstack add dialog Preferences            # Add a new dialog
-bootstack add i18n --languages en es fr     # Add i18n support
 bootstack doctor                            # Diagnose project & environment
+bootstack promote                           # Make the project packaging-ready
 bootstack build                             # Package for distribution
 ```
 
@@ -259,6 +270,12 @@ bootstack build                             # Package for distribution
 Full documentation — guides, the widget catalog, and the API reference — lives at
 **[bootstack.org](https://bootstack.org)**.
 
+## Contributing
+
+Contributions are welcome — code, bug reports, and especially **translations**.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, the pull-request
+workflow, and how to review the bundled language catalogs.
+
 ## Links
 
 - **GitHub**: https://github.com/israel-dryer/bootstack

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

@@ -18,11 +18,13 @@ bootstack gives engineers, data scientists, and hobbyists everything to build a
 polished desktop interface and package it into a standalone executable —
 declarative, reactive, and batteries-included, all in pure Python.
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-light.png">
   <img alt="bootstack hero demo" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/hero-light.png">
 </picture>
+</p>
 
 ## Why bootstack?
 
@@ -30,14 +32,14 @@ Most Python desktop frameworks make you fight the framework. bootstack gets out
 
 - **30% less code** — the declarative, context-manager layout eliminates geometry calls, explicit parenting, and most of the wiring boilerplate
 - **Reads like Python** — nested `with` blocks mirror your UI structure; the code hierarchy *is* the layout
-- **Modern layout system** — `HStack`, `VStack`, and `Grid` containers handle spacing, alignment, and fill automatically; CSS conventions (`gap`, `padding`, `margin`, `fill`, `anchor`) without writing CSS
+- **Modern layout system** — `Row`, `Column`, and `Grid` containers handle spacing, alignment, and growth automatically; a screen-axis vocabulary (`gap`, `padding`, `margin`, `horizontal`, `vertical`, `grow`) without writing CSS
 - **60+ widgets out of the box** — primitives through full composites: tables, trees, calendars, date pickers, gauges, sliders, and more — including a full `CodeEditor` with syntax highlighting, line numbers, bracket matching, smart indent, and search; no external editor dependency required
 - **Reactive signals** — observable state that flows between widgets; bind once, update everywhere
 - **Event and stream pipelines** — compose, filter, debounce, and throttle UI events with a chainable stream API
-- **Built-in icons** — the full Bootstrap Icons catalog, theme-aware and DPI-scaled, bundled with the framework
+- **Built-in icons** — the full Bootstrap Icons catalog, theme-aware and recolorable, bundled with the framework
 - **Built-in localization** — 23 language catalogs, locale-aware number/date/time formatting, runtime language switching
 - **Semantic styling** — `accent="primary"`, `variant="outline"` — no hard-coded colors; looks right across every theme automatically
-- **8 paired light/dark themes** — with a runtime switcher and a custom-theme API
+- **10 paired light/dark themes** — popular dev color schemes plus Bootstrap, with a runtime switcher and a custom-theme API
 - **Forms and validation** — field-level validators, inline error messages, and a `FormDialog` for quick modal forms
 - **DataSource abstraction** — one interface over SQLite, in-memory, and file backends with filtering, sorting, pagination, and CRUD
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
@@ -63,11 +65,13 @@ The widget gallery is a single-window tour of everything bootstack ships — eve
 bootstack gallery
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-light.png">
   <img alt="bootstack widget gallery" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/gallery-light.png">
 </picture>
+</p>
 
 ## Quick Start
 
@@ -83,24 +87,26 @@ with bs.App(title="Hello", padding=16, gap=16) as app:
 app.run()
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
   <img alt="bootstack quick start example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-quickstart-light.png">
 </picture>
+</p>
 
-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
 
 shell = bs.AppShell(title="My App", size=(1000, 650))
 
-with shell.add_page("home", text="Home", icon="house"):
-    bs.Label("Welcome!")
-
-with shell.add_page("docs", text="Documents", icon="file-earmark-text"):
-    bs.Label("Your documents.")
+with shell.page_nav() as nav:
+    with nav.add_page("home", text="Home", icon="house"):
+        bs.Label("Welcome!")
+    with nav.add_page("docs", text="Documents", icon="file-earmark-text"):
+        bs.Label("Your documents.")
 
 shell.run()
 ```
@@ -109,11 +115,11 @@ shell.run()
 
 ### Layout containers
 
-`VStack`, `HStack`, and `Grid` let you describe a layout once instead of repeating geometry calls on each child:
+`Column`, `Row`, and `Grid` let you describe a layout once instead of repeating geometry calls on each child:
 
 ```python
 with bs.App(title="Sign In") as app:
-    with bs.Grid(columns=["auto", 1], gap=(12, 6), sticky_items="ew", padding=16):
+    with bs.Grid(columns=["auto", 1], gap=(12, 6), horizontal_items="stretch", padding=16):
         bs.Label("Name:")
         bs.TextField(placeholder="Full name")
         bs.Label("Email:")
@@ -125,11 +131,13 @@ with bs.App(title="Sign In") as app:
 app.run()
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-light.png">
   <img alt="bootstack layout containers example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-layout-light.png">
 </picture>
+</p>
 
 ### Semantic styling
 
@@ -141,11 +149,13 @@ bs.Button("Cancel", accent="secondary", variant="outline")
 bs.Label("Heading", font="heading-lg")
 ```
 
+<p align="center">
 <picture>
   <source media="(prefers-color-scheme: dark)"  srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-dark.png">
   <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-light.png">
   <img alt="bootstack semantic styling example" src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/readme/ex-semantic-styling-light.png">
 </picture>
+</p>
 
 ### Signals (optional)
 
@@ -162,17 +172,17 @@ app.run()
 
 ## Features
 
-- **Application scaffolding** — `App` for blank windows, `AppShell` for command-bar + sidebar + page-stack apps, undecorated windows with custom chrome
+- **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, `Workbench` for two-tier workspace apps, undecorated windows with custom chrome
 - **60+ themed widgets** — primitives plus higher-level composites (DataTable, Tree, ListView, Calendar, DateField, Form, Gauge, ToggleGroup, PageStack, Carousel, Tooltip, and more)
 - **Dialogs and messages** — `alert()` / `confirm()` / `ask_*()` prompts and `FormDialog` / `FontDialog` / `FilterDialog`, plus non-blocking `toast()`, `Notification`, and `Snackbar` surfaces
-- **Layout containers** — `VStack`, `HStack`, and `Grid` for declarative layouts; `Card`, `GroupBox`, `ScrollView`, `SplitView`, `Accordion`, `Expander`
+- **Layout containers** — `Column`, `Row`, `Grid`, and `Spacer` for declarative layouts; `Card`, `GroupBox`, `ScrollView`, `SplitView`, `Accordion`, `Divider`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost), consistent across widgets
-- **Built-in themes** — paired light/dark variants (amber, aurora, bootstrap, classic, docs, forest, ocean, rose) with runtime theme switching and a custom-theme API
+- **Built-in themes** — 10 paired light/dark variants (bootstrap, catppuccin, dracula, everforest, gruvbox, nord, one, pydata, solarized, tokyo-night) with runtime theme switching and a custom-theme API
 - **Reactive signals** — observable state with subscribe/set, integrates with widgets via `signal=` / `textsignal=`
 - **Forms & validation** — `Form` with built-in field-level validators and inline error messages
 - **DataSource** — common interface over in-memory, SQLite, and file backends, with pagination, filtering, sorting, CRUD, and CSV/TSV/Excel export
 - **Localization (i18n)** — 23 bundled message catalogs, locale-aware number/date/time formatting via Babel, runtime language switching
-- **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring, DPI scaling, and caching
+- **Icons & images** — Bootstrap Icons catalog with theme-aware recoloring and caching
 - **Platform support** — DPI awareness, multi-monitor centering, mica/acrylic effects on Windows
 - **CLI (`bootstack`)** — project scaffolding, run, add components, theme/i18n setup, doctor, build/package
 
@@ -180,13 +190,13 @@ app.run()
 
 | Category | Widgets |
 |----------|---------|
-| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, CommandBar |
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar, ThemeToggle |
 | **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 |
+| **Layout** | Column, Row, Grid, Spacer, Card, GroupBox, SplitView, ScrollView, Accordion, Divider |
+| **Navigation** | AppShell, Workbench, Window, StatusBar, Tabs, PageStack |
 | **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
 | **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
 | **Forms** | Form, with field-level validation |
@@ -198,14 +208,15 @@ bootstack ships with an optional CLI for scaffolding, running, and packaging app
 ```bash
 bootstack gallery                           # Launch the interactive widget gallery
 bootstack icons                             # Browse the built-in icon catalog
+bootstack appicon                           # Design an app icon and export it
 bootstack start MyApp                       # Create a new project (basic template)
 bootstack start MyApp --template appshell   # ...or with sidebar navigation
 bootstack run                               # Run the app defined in the project config
 bootstack add page Dashboard                # Add a new page (appshell)
 bootstack add view Settings                 # Add a new view (basic)
 bootstack add dialog Preferences            # Add a new dialog
-bootstack add i18n --languages en es fr     # Add i18n support
 bootstack doctor                            # Diagnose project & environment
+bootstack promote                           # Make the project packaging-ready
 bootstack build                             # Package for distribution
 ```
 
@@ -214,6 +225,12 @@ bootstack build                             # Package for distribution
 Full documentation — guides, the widget catalog, and the API reference — lives at
 **[bootstack.org](https://bootstack.org)**.
 
+## Contributing
+
+Contributions are welcome — code, bug reports, and especially **translations**.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, the pull-request
+workflow, and how to review the bundled language catalogs.
+
 ## Links
 
 - **GitHub**: https://github.com/israel-dryer/bootstack

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a10"
+version = "0.1.0a12"
 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.0a12"
 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.0a12}/src/bootstack/__init__.py

@@ -11,9 +11,9 @@ Example:
     app.run()
     ```
 
-The top-level ``bootstack`` namespace holds what you *compose a UI* with: every
-widget, ``App``/``AppShell``/``Window``, ``Signal``, the dialog verbs
-(``alert``/``confirm``/``ask_*``/``toast``), and ``set_theme``/``toggle_theme``.
+The top-level `bootstack` namespace holds what you *compose a UI* with: every
+widget, `App`/`AppShell`/`Window`, `Signal`, the dialog verbs
+(`alert`/`confirm`/`ask_*`/`toast`), and `set_theme`/`toggle_theme`.
 Framework primitives you reference *by type to configure behavior* live in
 submodules — for example::
 
@@ -56,13 +56,14 @@ from bootstack.dialogs import (
 
 # ── Application & windows ─────────────────────────────────────────────────────
 from bootstack.widgets.app import App
-from bootstack.widgets.appshell import AppShell
+from bootstack.widgets.appshell import AppShell, Workbench
 from bootstack.widgets.window import Window
 
 # ── Public widget layer ───────────────────────────────────────────────────────
-from bootstack.widgets.stacks import HStack, VStack
+from bootstack.widgets.stacks import Row, Column, Spacer
 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
@@ -89,7 +90,7 @@ from bootstack.widgets.radiogroup import RadioGroup
 from bootstack.widgets.scrollview import ScrollView
 from bootstack.widgets.select import Select
 from bootstack.widgets.selectbutton import SelectButton
-from bootstack.widgets.separator import Separator
+from bootstack.widgets.divider import Divider
 from bootstack.widgets.splitview import SplitView, SplitPane
 from bootstack.widgets.slider import RangeSlider, Slider
 from bootstack.widgets.spinnerfield import SpinnerField
@@ -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
 
@@ -126,12 +127,12 @@ __all__ = [
     "ask_date_range", "ask_item", "ask_color", "ask_font", "ask_filter",
     "ask_save_file", "ask_open_file", "ask_open_files", "ask_directory",
     # Application & windows
-    "App", "AppShell", "Window",
+    "App", "AppShell", "Workbench", "Window",
     # Layout
-    "HStack", "VStack", "Grid", "Card", "GroupBox", "Separator", "ScrollView",
+    "Row", "Column", "Spacer", "Grid", "Card", "GroupBox", "Divider", "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.0a12}/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.0a12/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.0a12}/src/bootstack/_core/images.py

@@ -354,9 +354,9 @@ class _ImageService:
         LANCZOS blur at non-integer DPI scale factors (e.g., 125%, 150%).
 
         Args:
-            name: Bootstrap icon name (e.g., ``"house"``, ``"arrow-right-fill"``).
+            name: Bootstrap icon name (e.g., `"house"`, `"arrow-right-fill"`).
             size: Requested pixel size. Snapped to the nearest even integer.
-            color: Foreground color as a hex string (e.g., ``"#ffffff"``).
+            color: Foreground color as a hex string (e.g., `"#ffffff"`).
 
         Returns:
             A cached Tk-compatible PhotoImage for the icon.

{bootstack-0.1.0a10 → bootstack-0.1.0a12}/src/bootstack/_runtime/app.py

@@ -476,10 +476,10 @@ class App(BaseWindow, WidgetCapabilitiesMixin, tkinter.Tk):
             override_redirect: If `True`, creates a window without standard
                 decorations (title bar, borders, etc.).
             center_on_screen: If True (default), center the app window on
-                the screen when ``mainloop()`` starts.
+                the screen when `mainloop()` starts.
             on_close: Callback invoked when the user clicks the close button.
-                Return ``False`` to veto the close; return ``None`` or ``True``
-                to allow it. Equivalent to calling ``add_close_handler(fn)``
+                Return `False` to veto the close; return `None` or `True`
+                to allow it. Equivalent to calling `add_close_handler(fn)`
                 after construction.
             **kwargs: Additional keyword arguments to pass to the
                 underlying `tkinter.Tk` constructor.