bootstack 0.1.0a11__tar.gz → 0.1.0a13__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a11
+Version: 0.1.0a13
 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
@@ -35,6 +35,11 @@ Requires-Dist: pyarrow>=14; extra == "parquet"
 Provides-Extra: hdf5
 Requires-Dist: pandas>=2; extra == "hdf5"
 Requires-Dist: tables>=3.8; extra == "hdf5"
+Provides-Extra: viz
+Requires-Dist: matplotlib>=3.8; extra == "viz"
+Provides-Extra: viz-seaborn
+Requires-Dist: matplotlib>=3.8; extra == "viz-seaborn"
+Requires-Dist: seaborn>=0.13; extra == "viz-seaborn"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.2; extra == "docs"
 Requires-Dist: pydata-sphinx-theme; extra == "docs"
@@ -63,11 +68,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,16 +82,17 @@ 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
+- **Data visualization** — embed `matplotlib` (and `seaborn`) figures with `Chart`; they recolor with the theme and live-update from a `Signal` or `DataSource` (optional `viz` extra)
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
 - **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
 
@@ -108,11 +116,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 +138,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 +153,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 +166,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 +182,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 +200,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 +223,18 @@ 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
+- **Data visualization** — `Chart` embeds `matplotlib`/`seaborn` figures that theme themselves and live-update from a `Signal` or `DataSource`; managed render, blitting animation, and a themed navigation toolbar (optional `viz` / `viz-seaborn` extras)
 - **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 +242,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 +260,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 +277,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.0a13}/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,16 +32,17 @@ 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
+- **Data visualization** — embed `matplotlib` (and `seaborn`) figures with `Chart`; they recolor with the theme and live-update from a `Signal` or `DataSource` (optional `viz` extra)
 - **A real CLI** — scaffold, run, add pages/views/dialogs/themes, and package for distribution
 - **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
 
@@ -63,11 +66,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 +88,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 +103,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 +116,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 +132,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 +150,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 +173,18 @@ 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
+- **Data visualization** — `Chart` embeds `matplotlib`/`seaborn` figures that theme themselves and live-update from a `Signal` or `DataSource`; managed render, blitting animation, and a themed navigation toolbar (optional `viz` / `viz-seaborn` extras)
 - **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 +192,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 +210,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 +227,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.0a13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a11"
+version = "0.1.0a13"
 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"
@@ -73,6 +73,15 @@ hdf5 = [
     "pandas>=2",
     "tables>=3.8",
 ]
+# Visualization — embed matplotlib figures in a Chart widget.
+viz = [
+    "matplotlib>=3.8",
+]
+# Visualization with seaborn convenience layer on top of matplotlib.
+viz-seaborn = [
+    "matplotlib>=3.8",
+    "seaborn>=0.13",
+]
 docs = [
     "sphinx>=7.2",
     "pydata-sphinx-theme",
@@ -100,7 +109,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a11"
+current_version = "0.1.0a13"
 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}",
@@ -129,9 +138,10 @@ search = "version = \"{current_version}\""
 replace = "version = \"{new_version}\""
 
 [tool.pytest.ini_options]
-testpaths = ["tests/cli", "tests/widgets/public"]
+testpaths = ["tests/cli", "tests/widgets/public", "tests/data"]
 markers = [
     "gui: requires a Tk display (deselect with -m 'not gui')",
+    "isolated: constructs its own Tk root (App/AppShell/Window kwargs); must run in a dedicated process. Run the suite via `python tests/run_gui.py`, which executes the shared-root suite once and each isolated module in its own process.",
 ]
 
 [tool.ruff.lint]

{bootstack-0.1.0a11 → bootstack-0.1.0a13}/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
@@ -81,6 +81,7 @@ from bootstack.widgets.pagestack import PageStack, StackPage
 from bootstack.widgets.pathfield import PathField
 from bootstack.widgets.avatar import Avatar
 from bootstack.widgets.carousel import Carousel
+from bootstack.widgets.chart import Chart
 from bootstack.widgets.gallery import Gallery
 from bootstack.widgets.passwordfield import PasswordField
 from bootstack.widgets.picture import Picture
@@ -90,7 +91,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 +128,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",
@@ -143,7 +144,7 @@ __all__ = [
     # Data display
     "Label", "Badge", "ProgressBar", "Gauge", "ListView", "DataTable", "Tree", "TreeNode",
     # Media
-    "Picture", "Gallery", "Carousel", "Avatar",
+    "Picture", "Gallery", "Carousel", "Avatar", "Chart",
     # Navigation
     "PageStack", "StackPage", "Tabs", "TabPage",
     # Overlays

{bootstack-0.1.0a11 → bootstack-0.1.0a13}/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.0a13}/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.
@@ -675,6 +675,32 @@ class App(BaseWindow, WidgetCapabilitiesMixin, tkinter.Tk):
             except tkinter.TclError:
                 pass
         clear_current_app(self)
+        # Drop every process-wide cache that holds a Tk object bound to THIS
+        # root's interpreter — the Style singleton, the named/derived font
+        # caches, the nine-patch PhotoImage cache, and the visual-focus root
+        # ref. This must happen *before* super().destroy(): those cached
+        # PhotoImage/TkFont objects run `image delete`/`font delete` in their
+        # finalizers, and if they outlive the interpreter that owns them the
+        # call lands on a foreign/dead interpreter — a native crash in ttk
+        # element_create on the *next* root (the C layer, so Python can't catch
+        # it). Releasing + gc.collect() while this root is still alive lets the
+        # finalizers run cleanly. Only when no other App is live (single-App is
+        # the norm; this also lets the GUI test suite run module-after-module in
+        # one process, and fixes reopen-an-app-after-close in production).
+        if not has_current_app():
+            try:
+                import gc
+                from bootstack.style.style import reset_style
+                from bootstack.style.typography import Typography
+                from bootstack._core.images import _ImageService
+                from bootstack._runtime.visual_focus import reset_visual_focus_root
+                reset_style()
+                Typography.reset()
+                _ImageService.clear_cache()
+                reset_visual_focus_root()
+                gc.collect()
+            except Exception:
+                pass
         super().destroy()
 
     # ----- Window state persistence ------------------------------------------