bootstack 0.1.0a9__tar.gz → 0.1.0a11__tar.gz

bootstack-0.1.0a11/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 - 2026 Israel Dryer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bootstack-0.1.0a11/PKG-INFO

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: bootstack
+Version: 0.1.0a11
+Summary: From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging.
+Author-email: Israel Dryer <israel.dryer@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/israel-dryer/bootstack
+Project-URL: Documentation, https://bootstack.org/
+Keywords: tkinter,ttk,gui,desktop,python3,ui,widgets,theming,cross-platform,modern,framework,application-framework,desktop-ui,python-gui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: GTK
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: pillow<=12,>=10
+Requires-Dist: typing-extensions>=4.10
+Requires-Dist: Babel>=2.12
+Requires-Dist: python-dateutil>=2.9
+Requires-Dist: dateparser>=1.1
+Requires-Dist: pywinstyles>=1.8; sys_platform == "win32"
+Requires-Dist: screeninfo>=0.8
+Provides-Extra: excel
+Requires-Dist: XlsxWriter>=3; extra == "excel"
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=14; extra == "parquet"
+Provides-Extra: hdf5
+Requires-Dist: pandas>=2; extra == "hdf5"
+Requires-Dist: tables>=3.8; extra == "hdf5"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
+Requires-Dist: sphinx-design; extra == "docs"
+Requires-Dist: sphinx-copybutton; extra == "docs"
+Requires-Dist: sphinx-autobuild; extra == "docs"
+Dynamic: license-file
+
+![bootstack](https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/banner-readme.png)
+
+![](https://img.shields.io/github/release/israel-dryer/bootstack.svg)
+[![Downloads](https://pepy.tech/badge/bootstack)](https://pepy.tech/project/bootstack)
+[![Downloads](https://pepy.tech/badge/bootstack/month)](https://pepy.tech/project/bootstack)
+![](https://img.shields.io/github/issues/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/issues-closed/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/license/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/stars/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
+
+> **Pre-release.** The API may still change before 1.0. Full documentation is at
+> **[bootstack.org](https://bootstack.org)**.
+
+### From idea to a shipped desktop app — fast.
+
+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.
+
+<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>
+
+## Why bootstack?
+
+Most Python desktop frameworks make you fight the framework. bootstack gets out of the way.
+
+- **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
+- **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 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
+- **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
+- **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
+
+## Installation
+
+Requires Python 3.12+ and Tk/Tcl (bundled with most Python distributions).
+bootstack is in pre-release, so opt in with `--pre`:
+
+```bash
+python -m pip install --pre bootstack
+```
+
+See the [installation guide](https://bootstack.org/getting-started/installation/)
+for platform-specific Tk setup and the optional data-format extras.
+
+## See it
+
+The widget gallery is a single-window tour of everything bootstack ships — every widget, theme switcher, accent variants, and layout containers. Fastest way to see the framework in action without writing a line of code:
+
+```bash
+bootstack gallery
+```
+
+<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>
+
+## Quick Start
+
+```python
+import bootstack as bs
+
+with bs.App(title="Hello", padding=16, gap=16) as app:
+    bs.Label("Hello from bootstack!")
+    bs.Button("Primary", accent="primary")
+    bs.Button("Success", accent="success")
+    bs.Button("Danger Outline", accent="danger", variant="outline")
+
+app.run()
+```
+
+<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>
+
+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.")
+
+shell.run()
+```
+
+## How it works
+
+### Layout containers
+
+`VStack`, `HStack`, 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):
+        bs.Label("Name:")
+        bs.TextField(placeholder="Full name")
+        bs.Label("Email:")
+        bs.TextField(placeholder="email@example.com")
+        bs.Label("Role:")
+        bs.Select(options=["Admin", "User", "Viewer"], value="User")
+        bs.Button("Submit", accent="primary", columnspan=2)
+
+app.run()
+```
+
+<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>
+
+### Semantic styling
+
+Widgets take an `accent` (color intent) and `variant` (visual weight) instead of hard-coded colors, so the same code looks right across themes and light/dark modes:
+
+```python
+bs.Button("Save", accent="primary")
+bs.Button("Cancel", accent="secondary", variant="outline")
+bs.Label("Heading", font="heading-lg")
+```
+
+<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>
+
+### Signals (optional)
+
+Plain callbacks work fine for most things. When state needs to flow between widgets, signals give you a small reactive primitive with two-way binding:
+
+```python
+with bs.App(title="Hello") as app:
+    name = bs.Signal("World")
+    bs.Label(textsignal=name)      # updates automatically when name changes
+    bs.TextField(textsignal=name)  # two-way binding to the same state
+
+app.run()
+```
+
+## Features
+
+- **Application scaffolding** — `App` for blank windows, `AppShell` for command-bar + sidebar + page-stack 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`
+- **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
+- **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
+- **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
+
+## Widget Categories
+
+| Category | Widgets |
+|----------|---------|
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar |
+| **Inputs** | TextField, PasswordField, PathField, NumberField, SpinnerField, Slider, RangeSlider, TextArea, CodeEditor, DateField, TimeField |
+| **Selection** | Checkbox, Switch, ToggleButton, Radio, RadioGroup, ToggleGroup, Select, SelectButton, Calendar |
+| **Data Display** | Label, Badge, ListView, Tree, DataTable, ProgressBar, Gauge |
+| **Media** | Avatar, Picture, Gallery, Carousel |
+| **Layout** | VStack, HStack, Grid, Card, GroupBox, SplitView, ScrollView, Accordion, Separator |
+| **Navigation** | AppShell, SideNav, StatusBar, Tabs, PageStack |
+| **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
+| **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
+| **Forms** | Form, with field-level validation |
+
+## CLI
+
+bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
+
+```bash
+bootstack gallery                           # Launch the interactive widget gallery
+bootstack icons                             # Browse the built-in icon catalog
+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 build                             # Package for distribution
+```
+
+## Documentation
+
+Full documentation — guides, the widget catalog, and the API reference — lives at
+**[bootstack.org](https://bootstack.org)**.
+
+## Links
+
+- **GitHub**: https://github.com/israel-dryer/bootstack

bootstack-0.1.0a11/README.md

@@ -0,0 +1,219 @@
+![bootstack](https://raw.githubusercontent.com/israel-dryer/bootstack/main/assets/banner-readme.png)
+
+![](https://img.shields.io/github/release/israel-dryer/bootstack.svg)
+[![Downloads](https://pepy.tech/badge/bootstack)](https://pepy.tech/project/bootstack)
+[![Downloads](https://pepy.tech/badge/bootstack/month)](https://pepy.tech/project/bootstack)
+![](https://img.shields.io/github/issues/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/issues-closed/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/license/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/stars/israel-dryer/bootstack.svg)
+![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
+
+> **Pre-release.** The API may still change before 1.0. Full documentation is at
+> **[bootstack.org](https://bootstack.org)**.
+
+### From idea to a shipped desktop app — fast.
+
+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.
+
+<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>
+
+## Why bootstack?
+
+Most Python desktop frameworks make you fight the framework. bootstack gets out of the way.
+
+- **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
+- **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 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
+- **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
+- **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
+
+## Installation
+
+Requires Python 3.12+ and Tk/Tcl (bundled with most Python distributions).
+bootstack is in pre-release, so opt in with `--pre`:
+
+```bash
+python -m pip install --pre bootstack
+```
+
+See the [installation guide](https://bootstack.org/getting-started/installation/)
+for platform-specific Tk setup and the optional data-format extras.
+
+## See it
+
+The widget gallery is a single-window tour of everything bootstack ships — every widget, theme switcher, accent variants, and layout containers. Fastest way to see the framework in action without writing a line of code:
+
+```bash
+bootstack gallery
+```
+
+<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>
+
+## Quick Start
+
+```python
+import bootstack as bs
+
+with bs.App(title="Hello", padding=16, gap=16) as app:
+    bs.Label("Hello from bootstack!")
+    bs.Button("Primary", accent="primary")
+    bs.Button("Success", accent="success")
+    bs.Button("Danger Outline", accent="danger", variant="outline")
+
+app.run()
+```
+
+<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>
+
+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.")
+
+shell.run()
+```
+
+## How it works
+
+### Layout containers
+
+`VStack`, `HStack`, 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):
+        bs.Label("Name:")
+        bs.TextField(placeholder="Full name")
+        bs.Label("Email:")
+        bs.TextField(placeholder="email@example.com")
+        bs.Label("Role:")
+        bs.Select(options=["Admin", "User", "Viewer"], value="User")
+        bs.Button("Submit", accent="primary", columnspan=2)
+
+app.run()
+```
+
+<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>
+
+### Semantic styling
+
+Widgets take an `accent` (color intent) and `variant` (visual weight) instead of hard-coded colors, so the same code looks right across themes and light/dark modes:
+
+```python
+bs.Button("Save", accent="primary")
+bs.Button("Cancel", accent="secondary", variant="outline")
+bs.Label("Heading", font="heading-lg")
+```
+
+<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>
+
+### Signals (optional)
+
+Plain callbacks work fine for most things. When state needs to flow between widgets, signals give you a small reactive primitive with two-way binding:
+
+```python
+with bs.App(title="Hello") as app:
+    name = bs.Signal("World")
+    bs.Label(textsignal=name)      # updates automatically when name changes
+    bs.TextField(textsignal=name)  # two-way binding to the same state
+
+app.run()
+```
+
+## Features
+
+- **Application scaffolding** — `App` for blank windows, `AppShell` for command-bar + sidebar + page-stack 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`
+- **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
+- **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
+- **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
+
+## Widget Categories
+
+| Category | Widgets |
+|----------|---------|
+| **Actions** | Button, ButtonGroup, MenuButton, ContextMenu, Toolbar |
+| **Inputs** | TextField, PasswordField, PathField, NumberField, SpinnerField, Slider, RangeSlider, TextArea, CodeEditor, DateField, TimeField |
+| **Selection** | Checkbox, Switch, ToggleButton, Radio, RadioGroup, ToggleGroup, Select, SelectButton, Calendar |
+| **Data Display** | Label, Badge, ListView, Tree, DataTable, ProgressBar, Gauge |
+| **Media** | Avatar, Picture, Gallery, Carousel |
+| **Layout** | VStack, HStack, Grid, Card, GroupBox, SplitView, ScrollView, Accordion, Separator |
+| **Navigation** | AppShell, SideNav, StatusBar, Tabs, PageStack |
+| **Dialogs** | `alert()`, `confirm()`, `ask_*()` prompts, FormDialog, FontDialog, FilterDialog |
+| **Overlays** | `toast()`, Notification, Snackbar, Tooltip |
+| **Forms** | Form, with field-level validation |
+
+## CLI
+
+bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
+
+```bash
+bootstack gallery                           # Launch the interactive widget gallery
+bootstack icons                             # Browse the built-in icon catalog
+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 build                             # Package for distribution
+```
+
+## Documentation
+
+Full documentation — guides, the widget catalog, and the API reference — lives at
+**[bootstack.org](https://bootstack.org)**.
+
+## Links
+
+- **GitHub**: https://github.com/israel-dryer/bootstack

bootstack-0.1.0a11/pyproject.toml

@@ -0,0 +1,139 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bootstack"
+version = "0.1.0a11"
+description = "From idea to a shipped desktop app, fast — a declarative, reactive, batteries-included Python UI framework with 60+ widgets, semantic theming, and built-in packaging."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+    { name = "Israel Dryer", email = "israel.dryer@gmail.com" }
+]
+keywords = [
+    "tkinter",
+    "ttk",
+    "gui",
+    "desktop",
+    "python3",
+    "ui",
+    "widgets",
+    "theming",
+    "cross-platform",
+    "modern",
+    "framework",
+    "application-framework",
+    "desktop-ui",
+    "python-gui"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications :: GTK",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: User Interfaces",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "pillow>=10,<=12",
+
+    # Backported typing primitives (Self, Unpack, ParamSpec, etc.)
+    "typing-extensions>=4.10",
+
+    # Runtime localization/formatting stack
+    "Babel>=2.12",
+    "python-dateutil>=2.9",
+    "dateparser>=1.1",
+
+    # Windows-specific: modern window effects (mica, acrylic, etc.)
+    "pywinstyles>=1.8; sys_platform == 'win32'",
+
+    # Multi-monitor support for proper window centering
+    "screeninfo>=0.8",
+]
+
+[project.optional-dependencies]
+# Excel (.xlsx) export for Table. Write-only, zero-dependency, pure Python.
+excel = [
+    "XlsxWriter>=3",
+]
+# Columnar formats — read/write Parquet and Feather/Arrow via pyarrow.
+parquet = [
+    "pyarrow>=14",
+]
+# Scientific tabular format — read/write HDF5 via pandas + PyTables.
+hdf5 = [
+    "pandas>=2",
+    "tables>=3.8",
+]
+docs = [
+    "sphinx>=7.2",
+    "pydata-sphinx-theme",
+    "sphinx-design",
+    "sphinx-copybutton",
+    "sphinx-autobuild",
+]
+
+[project.urls]
+Homepage = "https://github.com/israel-dryer/bootstack"
+Documentation = "https://bootstack.org/"
+
+[project.scripts]
+bootstack = "bootstack.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"bootstack" = [
+    "assets/*",
+    "assets/icons/*",
+    # ship compiled gettext catalogs within the package
+    "assets/locales/**/LC_MESSAGES/*.mo",
+]
+
+[tool.bumpversion]
+current_version = "0.1.0a11"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)((?P<pre>a|b|rc)(?P<pre_n>\\d+))?"
+serialize = [
+    "{major}.{minor}.{patch}{pre}{pre_n}",
+    "{major}.{minor}.{patch}",
+]
+search = "version = \"{current_version}\""
+replace = "version = \"{new_version}\""
+commit = true
+tag = true
+tag_name = "v{new_version}"
+tag_message = "Release {new_version}"
+message = "Release {new_version}"
+allow_dirty = false
+
+[tool.bumpversion.parts.pre]
+optional_value = ""
+first_value = ""
+values = ["", "a", "b", "rc"]
+
+[tool.bumpversion.parts.pre_n]
+first_value = "1"
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = "version = \"{current_version}\""
+replace = "version = \"{new_version}\""
+
+[tool.pytest.ini_options]
+testpaths = ["tests/cli", "tests/widgets/public"]
+markers = [
+    "gui: requires a Tk display (deselect with -m 'not gui')",
+]
+
+[tool.ruff.lint]
+# F401: imported but unused — suppress for __init__.py where all imports are public re-exports
+per-file-ignores = { "src/bootstack/__init__.py" = ["F401"] }