bootstack 0.1.0a11__tar.gz → 0.1.0a12__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a11
+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,11 +132,13 @@ 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 stacked toolbars, a sidebar, and a page stack in one call:
 
@@ -141,11 +147,11 @@ 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, Toolbar |
+| **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, 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.0a11 → 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,11 +87,13 @@ 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 stacked toolbars, a sidebar, and a page stack in one call:
 
@@ -96,11 +102,11 @@ 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, Toolbar |
+| **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, 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.0a11 → bootstack-0.1.0a12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a11"
+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.0a11"
+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.0a11 → 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,11 +56,11 @@ 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
@@ -90,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
@@ -127,9 +127,9 @@ __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", "ThemeToggle", "MenuButton", "Toolbar", "StatusBar",

{bootstack-0.1.0a11 → 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.0a11 → 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.

{bootstack-0.1.0a11 → bootstack-0.1.0a12}/src/bootstack/_runtime/base_window.py

@@ -196,10 +196,25 @@ class BaseWindow:
             pywinstyles.apply_style(self, window_style)
             self._window_style_applied = True
             self.after(0, self._update_chrome_color)
-            self.bind('<<ThemeChanged>>', lambda e: self.after(0, self._update_chrome_color), add='+')
+            self.bind('<<ThemeChanged>>', self._schedule_chrome_update, add='+')
         except Exception:
             pass
 
+    def _schedule_chrome_update(self, _event=None) -> None:
+        """Coalesce chrome re-tinting on theme change.
+
+        The toplevel receives `<<ThemeChanged>>` ~1400x per theme rebuild (once
+        per ttk style reconfigure). Cancel any pending update and schedule a
+        single one so the (DWM) chrome repaint runs once, not hundreds of times.
+        """
+        pending = getattr(self, '_chrome_update_after', None)
+        if pending is not None:
+            try:
+                self.after_cancel(pending)
+            except Exception:
+                pass
+        self._chrome_update_after = self.after(0, self._update_chrome_color)
+
     def _update_chrome_color(self) -> None:
         if getattr(self, '_updating_chrome', False):
             return
@@ -208,10 +223,15 @@ class BaseWindow:
             import pywinstyles
             from bootstack.style.style import get_theme_provider
             color = get_theme_provider().colors['chrome']
-            pywinstyles.change_header_color(self, color)
-            # Match the window border to the chrome too, so it honors the theme
-            # (otherwise Windows leaves a light default border in dark mode).
-            pywinstyles.change_border_color(self, color)
+            # The DWM header/border calls are expensive (~100ms each); skip them
+            # when the chrome color is unchanged (redundant theme events, or a
+            # theme switch that keeps the same chrome).
+            if getattr(self, '_chrome_color_applied', None) != color:
+                self._chrome_color_applied = color
+                pywinstyles.change_header_color(self, color)
+                # Match the window border to the chrome too, so it honors the
+                # theme (otherwise Windows leaves a light border in dark mode).
+                pywinstyles.change_border_color(self, color)
         except Exception:
             pass
         finally:
@@ -322,9 +342,9 @@ class BaseWindow:
     def _close_dispatch(self) -> None:
         """WM_DELETE_WINDOW handler that runs registered close handlers.
 
-        Runs each handler in registration order. If any returns ``False`` the
-        close is vetoed and the window stays open. If all pass (return ``None``
-        or ``True``), ``_do_close()`` is called to perform the actual close.
+        Runs each handler in registration order. If any returns `False` the
+        close is vetoed and the window stays open. If all pass (return `None`
+        or `True`), `_do_close()` is called to perform the actual close.
         """
         for handler in list(getattr(self, '_close_handlers', [])):
             try:
@@ -339,7 +359,7 @@ class BaseWindow:
         """Perform the default close action.
 
         Subclasses may override this to change what happens after all handlers
-        pass. The default is ``self.destroy()``.
+        pass. The default is `self.destroy()`.
         """
         try:
             self.destroy()
@@ -350,8 +370,8 @@ class BaseWindow:
         """Close the window programmatically, bypassing the close handlers.
 
         This is the uniform close contract every top-level window honors. It
-        performs the default close action directly (``_do_close()``), so the
-        veto handlers registered with ``add_close_handler()`` — which guard the
+        performs the default close action directly (`_do_close()`), so the
+        veto handlers registered with `add_close_handler()` — which guard the
         user clicking the window's close button — are not run. The application
         root overrides this to quit its event loop instead.
         """
@@ -360,13 +380,13 @@ class BaseWindow:
     def add_close_handler(self, callback: Callable[[], bool | None]) -> None:
         """Register a callback invoked when the window's close button is clicked.
 
-        Handlers are called in registration order. Return ``False`` from a
-        handler to veto the close; return ``None`` or ``True`` to allow it.
+        Handlers are called in registration order. Return `False` from a
+        handler to veto the close; return `None` or `True` to allow it.
         All handlers that pass are run before the window closes.
 
         Args:
             callback: Called with no arguments when close is requested.
-                Return ``False`` to cancel the close, ``None`` or ``True`` to proceed.
+                Return `False` to cancel the close, `None` or `True` to proceed.
         """
         self._init_close_handlers()
         self._close_handlers.append(callback)
@@ -625,12 +645,12 @@ class BaseWindow:
     def on_close(self, handler: Callable[[], bool | None]) -> None:
         """Register a handler for the window close button.
 
-        Equivalent to ``add_close_handler(handler)``. Handlers are called in
-        registration order; return ``False`` to veto the close.
+        Equivalent to `add_close_handler(handler)`. Handlers are called in
+        registration order; return `False` to veto the close.
 
         Args:
             handler: Called with no arguments when close is requested.
-                Return ``False`` to cancel, ``None`` or ``True`` to proceed.
+                Return `False` to cancel, `None` or `True` to proceed.
         """
         self.add_close_handler(handler)