bootstack 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

bootstack/widgets/_core/base.py

@@ -282,7 +282,9 @@ class PublicWidgetBase:
         Example:
             .. code-block:: python
 
-               widget.emit("change", data=bs.events.ChangeEvent(value=new_value))
+               from bootstack.events import ChangeEvent
+
+               field.emit("change", data=ChangeEvent(value=new_value))
         """
         sequence = resolve_event(self, str(event))
 

bootstack/widgets/_impl/composites/tableview/tableview.py

@@ -29,7 +29,7 @@ from bootstack.style.style import get_style
 from bootstack.data.sqlite_source import SqliteDataSource
 from bootstack.data.query import col, any_of, all_of
 from bootstack.widgets._impl.primitives.button import Button
-from bootstack._runtime.utility import bind_right_click
+from bootstack._runtime.utility import bind_right_click, debug_log_exception
 from bootstack.widgets._impl.composites.contextmenu import ContextMenu
 from bootstack.widgets._impl.composites.tooltip import ToolTip
 from bootstack.widgets._impl.composites.dropdownbutton import DropdownButton
@@ -1148,8 +1148,8 @@ class TableView(Frame):
         self._tree.bind("<Button-1>", self._on_header_click)
         self._tree.bind("<<TreeviewSelect>>", self._on_selection_event)
         # Keep group-header chevrons in sync with their open/closed state.
-        self._tree.bind("<<TreeviewOpen>>", self._refresh_group_chevrons, add="+")
-        self._tree.bind("<<TreeviewClose>>", self._refresh_group_chevrons, add="+")
+        self._tree.bind("<<TreeviewOpen>>", self._refresh_group_chevrons_deferred, add="+")
+        self._tree.bind("<<TreeviewClose>>", self._refresh_group_chevrons_deferred, add="+")
         self._tree.bind("<ButtonRelease-1>", self._on_row_click_event)
         # Escape clears the selection (also reachable in single-select mode, where
         # clicking can't return to an empty selection). Bound on the tree widget
@@ -1158,8 +1158,10 @@ class TableView(Frame):
         self._tree.bind("<Escape>", lambda _e: self.deselect_all(), add="+")
         if self._context_menus != "none":
             bind_right_click(self._tree, self._on_tree_context)
-        if self._editing['updating']:
-            self._tree.bind("<Double-1>", self._on_row_double_click)
+        # Bound unconditionally: `on_row_double_click` is public API and does not
+        # depend on editing. The handler itself gates the built-in edit dialog on
+        # `_editing['updating']`, so editing behavior is unchanged.
+        self._tree.bind("<Double-1>", self._on_row_double_click)
         # Track resize events to rebalance grouped layouts
         self._tree.bind("<Configure>", self._on_tree_configure)
 
@@ -1690,9 +1692,12 @@ class TableView(Frame):
             col_idx = 0
         # Right-click does not alter the selection (left-click owns that); it
         # only records which row the menu targets and opens the menu there.
-        self._context_iid = iid or None
-        if not iid:
+        # A group header is a real tree item but holds no record — it is absent
+        # from `_row_map` — so it targets nothing, exactly like empty space.
+        if not iid or iid not in self._row_map:
+            self._context_iid = None
             return  # empty space or a group-header row — no row menu
+        self._context_iid = iid
         rec = self._row_map.get(iid, {})
         self.event_generate("<<RowRightClick>>", data=RowEvent(record=self._public_record(rec), id=self._record_id(rec)))
         self._row_menu_col = col_idx
@@ -1704,8 +1709,8 @@ class TableView(Frame):
         if region == "heading":
             return
         iid = self._tree.identify_row(event.y)
-        if not iid:
-            return
+        if not iid or iid not in self._row_map:
+            return  # empty space or a group-header row (no record)
         rec = self._row_map.get(iid, {})
         self.event_generate("<<RowDoubleClick>>", data=RowEvent(record=self._public_record(rec), id=self._record_id(rec)))
         if self._editing['updating']:
@@ -2343,6 +2348,19 @@ class TableView(Frame):
         except Exception:
             pass
 
+    def _refresh_group_chevrons_deferred(self, _event=None) -> None:
+        """Refresh chevrons once Tk has applied the item's new open state.
+
+        The toolkit reports an expand *before* it records it, so reading the
+        state inside the notification paints the previous chevron. Deferring to
+        the next idle point reads the settled state. Scheduled on the root so
+        the pending callback outlives any widget being torn down.
+        """
+        try:
+            self._root().after_idle(self._refresh_group_chevrons)
+        except Exception:
+            pass
+
     def _refresh_group_chevrons(self, _event=None) -> None:
         """Sync every group header's chevron to its current open/closed state."""
         if not self._group_by_key:
@@ -2845,6 +2863,23 @@ class TableView(Frame):
         """
         return self._selection_markers_active()
 
+    def _take_click_focus(self, iid) -> None:
+        """Give the body keyboard focus, and point it at the clicked row.
+
+        Both branches that call this answer the click themselves and stop it,
+        which also stops the built-in handling that would otherwise have done
+        this. Without it a click leaves the keyboard aimed somewhere else, so
+        the row the user just clicked is not the row the arrow keys move from.
+        """
+        try:
+            self._tree.focus_set()
+            if iid:
+                self._tree.focus(iid)
+        except Exception:
+            # Silence here would restore the very bug this method exists to
+            # fix, with nothing to show for it on any channel.
+            debug_log_exception("could not move keyboard focus to the clicked row")
+
     def _on_header_click(self, event):
         """Handle left-click: header sorting, or toggle-select with checkboxes."""
         # A left-click on the tree dismisses an open context menu. Do it
@@ -2873,20 +2908,25 @@ class TableView(Frame):
         # fall through to normal selection below.
         iid = self._tree.identify_row(event.y)
         if iid and self._tree.get_children(iid):
+            self._take_click_focus(iid)
             self._toggle_group_open(iid)
             return "break"
 
         # Body click with checkboxes showing: treat the list like a checklist —
         # a plain click toggles the row in/out of the selection (no modifier),
         # and "break" suppresses ttk's default replace-the-selection behavior.
+        # Only a click that lands on a row earns that "break" — a click on a
+        # column separator reports no row, and stopping it there would kill the
+        # drag that resizes the column.
         if self._toggle_select_active():
             iid = self._tree.identify_row(event.y)
             if iid:
+                self._take_click_focus(iid)
                 if iid in self._tree.selection():
                     self._tree.selection_remove(iid)
                 else:
                     self._tree.selection_add(iid)
-            return "break"
+                return "break"
         return None
 
     def _filter_header_column(self) -> None:

{bootstack-0.2.1.dist-info → bootstack-0.2.2.dist-info}/METADATA

@@ -1,302 +1,302 @@
-Metadata-Version: 2.4
-Name: bootstack
-Version: 0.2.1
-Summary: Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate.
-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 :: 4 - Beta
-Classifier: Environment :: Win32 (MS Windows)
-Classifier: Environment :: MacOS X
-Classifier: Environment :: X11 Applications
-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: pygments>=2.15
-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: 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"
-Requires-Dist: sphinx-design; extra == "docs"
-Requires-Dist: sphinx-copybutton; extra == "docs"
-Requires-Dist: sphinx-autobuild; extra == "docs"
-Requires-Dist: myst-parser; 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)
-
-> Full documentation is at **[bootstack.org](https://bootstack.org)**.
-
-### Desktop apps in pure Python — Tk underneath, none of the boilerplate.
-
-bootstack is built on Tk, so the install is light and your app ships as a small standalone executable. But you'll never
-write a `StringVar` or call `.pack()` — the API is its own. 60+ widgets, reactive state, and a CLI that scaffolds and
-packages the whole thing.
-
-<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?
-
-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** — `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 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
-- **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
-- **Hot reload** — `bootstack dev app.py` updates the running app on save and keeps your place; module-level state and the active page survive the reload
-- **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
-
-## Hot reload
-
-Edit and save — the running window updates in place. `bootstack dev app.py`
-reloads the UI on every save while keeping your window position, module-level
-state, and active page, so you never lose your spot.
-
-<p align="center">
-<video src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/docs/_static/examples/live-reload.mp4" controls muted loop playsinline></video>
-</p>
-
-## Installation
-
-Requires Python 3.12+ and Tk/Tcl (bundled with most Python distributions).
-Install with pip:
-
-```bash
-python -m pip install 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
-```
-
-<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
-
-```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()
-```
-
-<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:
-
-```python
-import bootstack as bs
-
-shell = bs.AppShell(title="My App", size=(1000, 650))
-
-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()
-```
-
-## How it works
-
-### Layout containers
-
-`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), horizontal_items="stretch", 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()
-```
-
-<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
-
-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")
-```
-
-<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)
-
-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 toolbar + sidebar + page-stack apps, `Workbench` for two-tier workspace apps, `Splash` for a startup intro screen, 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** — `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** — 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 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, 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** | Column, Row, Grid, Spacer, Card, GroupBox, SplitView, ScrollView, Accordion, Divider |
-| **Navigation** | AppShell, Workbench, Window, Splash, 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 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 dev app.py                        # Run with hot reload (live edit-and-save)
-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 doctor                            # Diagnose project & environment
-bootstack promote                           # Make the project packaging-ready
-bootstack build                             # Package for distribution
-```
-
-## Documentation
-
-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
+Metadata-Version: 2.4
+Name: bootstack
+Version: 0.2.2
+Summary: Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate.
+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 :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Environment :: X11 Applications
+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: pygments>=2.15
+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: 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"
+Requires-Dist: sphinx-design; extra == "docs"
+Requires-Dist: sphinx-copybutton; extra == "docs"
+Requires-Dist: sphinx-autobuild; extra == "docs"
+Requires-Dist: myst-parser; 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)
+
+> Full documentation is at **[bootstack.org](https://bootstack.org)**.
+
+### Desktop apps in pure Python — Tk underneath, none of the boilerplate.
+
+bootstack is built on Tk, so the install is light and your app ships as a small standalone executable. But you'll never
+write a `StringVar` or call `.pack()` — the API is its own. 60+ widgets, reactive state, and a CLI that scaffolds and
+packages the whole thing.
+
+<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?
+
+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** — `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 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
+- **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
+- **Hot reload** — `bootstack dev app.py` updates the running app on save and keeps your place; module-level state and the active page survive the reload
+- **PyInstaller packaging built in** — `bootstack build` produces a standalone executable; no separate toolchain required
+
+## Hot reload
+
+Edit and save — the running window updates in place. `bootstack dev app.py`
+reloads the UI on every save while keeping your window position, module-level
+state, and active page, so you never lose your spot.
+
+<p align="center">
+<video src="https://raw.githubusercontent.com/israel-dryer/bootstack/main/docs/_static/examples/live-reload.mp4" controls muted loop playsinline></video>
+</p>
+
+## Installation
+
+Requires Python 3.12+ and Tk/Tcl (bundled with most Python distributions).
+Install with pip:
+
+```bash
+python -m pip install 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
+```
+
+<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
+
+```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()
+```
+
+<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:
+
+```python
+import bootstack as bs
+
+shell = bs.AppShell(title="My App", size=(1000, 650))
+
+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()
+```
+
+## How it works
+
+### Layout containers
+
+`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), horizontal_items="stretch", 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()
+```
+
+<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
+
+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")
+```
+
+<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)
+
+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 toolbar + sidebar + page-stack apps, `Workbench` for two-tier workspace apps, `Splash` for a startup intro screen, 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** — `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** — 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 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, 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** | Column, Row, Grid, Spacer, Card, GroupBox, SplitView, ScrollView, Accordion, Divider |
+| **Navigation** | AppShell, Workbench, Window, Splash, 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 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 dev app.py                        # Run with hot reload (live edit-and-save)
+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 doctor                            # Diagnose project & environment
+bootstack promote                           # Make the project packaging-ready
+bootstack build                             # Package for distribution
+```
+
+## Documentation
+
+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.2.1.dist-info → bootstack-0.2.2.dist-info}/RECORD

@@ -322,7 +322,7 @@ bootstack/widgets/types.py,sha256=_86PwJ20gim0hGnCdPYSn1YVrrsTfZhyQ1zWDwHqQTY,13
 bootstack/widgets/window.py,sha256=lwzYO6uAeXM_lSMXES911OsX8aVrJPKQHJu1u30bAIo,12921
 bootstack/widgets/_core/__init__.py,sha256=rJPvvI3eOV9M5cICBD2XPZFokThf_tQyTeZhLPaqukU,1106
 bootstack/widgets/_core/app_config.py,sha256=h_OaJ0jSif1eJeHWErpsXNyhtfCcmYQCcq0VriM48uk,9771
-bootstack/widgets/_core/base.py,sha256=NWJWqG-rbFRadnacCdnIueQUht6XEtVFoEChU5t7VSw,22691
+bootstack/widgets/_core/base.py,sha256=LOLzA-m3NpcFi05b-W77r5W73efR5mgceq6xIsZJ4Ps,22739
 bootstack/widgets/_core/choices.py,sha256=IGm4NspPJQgnGOxfuXWsqs4nSk7HSkdH0P60Cd1gnjo,2369
 bootstack/widgets/_core/container.py,sha256=zrMadhoswXERiY4jjzeot2dnqpus-PKmG_vHESiuoqM,16051
 bootstack/widgets/_core/context.py,sha256=laL75HYr7kIx3KbZqtT_rO1wWRjV4pehNzWgcZUkw_I,764
@@ -402,7 +402,7 @@ bootstack/widgets/_impl/composites/slider/_shared.py,sha256=xbwghVe-mKno5gDJsQNX
 bootstack/widgets/_impl/composites/slider/rangeslider.py,sha256=xhzv68hhSx2iImtPdXBzuk9p41tdOJxzdl8APnGAnhY,43770
 bootstack/widgets/_impl/composites/slider/slider.py,sha256=OWdhzahCDsXP1xNtDoHb82iQMbtYyzR895CePBbEQP0,38996
 bootstack/widgets/_impl/composites/tableview/__init__.py,sha256=ccQKtGH53tGj7K1ezfsbY2iEyIH1wRgd1qEQ0Glqra4,127
-bootstack/widgets/_impl/composites/tableview/tableview.py,sha256=YAhgiLvDMwH_5Qx6_d-StXlI748anf0HpLj0QDzidMI,148479
+bootstack/widgets/_impl/composites/tableview/tableview.py,sha256=Qr7UwHxRB6p9mG6WDD5rZblEi3TvxuYwnk6TJXKgA1Q,150713
 bootstack/widgets/_impl/composites/tableview/types.py,sha256=oDmJco19M42Zv_lUEpsfeM7kjjuHHsNBMVZoWRe-QDs,4906
 bootstack/widgets/_impl/composites/tabs/__init__.py,sha256=yRRJCO9egzFCDNN7xDyQcH8KqCQx6AgGE-eVtpn4KSc,427
 bootstack/widgets/_impl/composites/tabs/tabitem.py,sha256=WGCxBU2ObqFVLVa5p4KfBLp7QvJ-Y8sLfUkJjXP4820,14754
@@ -465,10 +465,10 @@ bootstack/widgets/_impl/primitives/sizegrip.py,sha256=uwQRzOEHjNPXtUURhT6k2TNYdy
 bootstack/widgets/_impl/primitives/spinbox.py,sha256=5m0tZrqCw745nvIiBrJWnZ0q8fZ7bNEvopjROMbQolc,4526
 bootstack/widgets/_impl/primitives/switch.py,sha256=7dt43uE2P_WdkxZZsGtCFRAQ20nI2jx5VUqGSrWwEmA,2543
 bootstack/widgets/_impl/primitives/treeview.py,sha256=vnSowgzmtNEWst_i9ZgcacHjdvuheF9xmeTvTWE1bLg,2709
-bootstack-0.2.1.dist-info/licenses/LICENSE,sha256=CUeTPUOM8Qc0yuqneJUwuUmDBooET5UfsHjMrkdBeCg,1097
-bootstack-0.2.1.dist-info/licenses/NOTICE,sha256=-wgrIMRWBeNKGVXd48W43hf2xv9zDLzRyemn5tkgZIE,370
-bootstack-0.2.1.dist-info/METADATA,sha256=OTjxaH158rVV2viKWpoDXPuUG9NNtaSpQY9qunOZ9Xk,16107
-bootstack-0.2.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-bootstack-0.2.1.dist-info/entry_points.txt,sha256=phOlfRy3Th86IYlNhQiUrTLLLzxie1IG-kMas_5iMdA,49
-bootstack-0.2.1.dist-info/top_level.txt,sha256=IsKBAac2vRCegvRFSCzwcBr7TpHp4bLnLFgA75LOkXs,10
-bootstack-0.2.1.dist-info/RECORD,,
+bootstack-0.2.2.dist-info/licenses/LICENSE,sha256=CUeTPUOM8Qc0yuqneJUwuUmDBooET5UfsHjMrkdBeCg,1097
+bootstack-0.2.2.dist-info/licenses/NOTICE,sha256=-wgrIMRWBeNKGVXd48W43hf2xv9zDLzRyemn5tkgZIE,370
+bootstack-0.2.2.dist-info/METADATA,sha256=yefZeA7n_PxLWN5n6WhxoVNMD45CZZbSHbG9ecBLkkc,16409
+bootstack-0.2.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+bootstack-0.2.2.dist-info/entry_points.txt,sha256=phOlfRy3Th86IYlNhQiUrTLLLzxie1IG-kMas_5iMdA,49
+bootstack-0.2.2.dist-info/top_level.txt,sha256=IsKBAac2vRCegvRFSCzwcBr7TpHp4bLnLFgA75LOkXs,10
+bootstack-0.2.2.dist-info/RECORD,,