bootstack 0.1.0a3__tar.gz → 0.1.0a5__tar.gz

{bootstack-0.1.0a3/src/bootstack.egg-info → bootstack-0.1.0a5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a3
+Version: 0.1.0a5
 Summary: A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT
@@ -44,9 +44,16 @@ Dynamic: license-file
 ![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
 
 
-**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+> **From the maker of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap).**
 
-The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+**bootstack** is a batteries-included desktop framework for Python, built on Tk.
+
+60+ themed widgets. Reactive state. Declarative layout. Built-in icons and localization. A CLI that scaffolds, builds, and ships. Everything ttkbootstrap was missing.
+
+<p align="center">
+  <img src="docs/assets/hero-demo-app-light.png" width="49%" alt="bootstack Data Analysis Workbench — light theme">
+  <img src="docs/assets/hero-demo-app-dark.png" width="49%" alt="bootstack Data Analysis Workbench — dark theme">
+</p>
 
 > **Active alpha.** APIs may change before the first stable release.
 > See the [documentation](https://bootstack.org) for guides and the API reference.
@@ -61,6 +68,14 @@ bootstack is currently in **active alpha**, so the `--pre` flag is required to o
 pip install --pre bootstack
 ```
 
+## 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
+```
+
 ## Quick Start
 
 ```python
@@ -136,7 +151,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 ## Features
 
 - **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
-- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **60+ themed widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
 - **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
 - **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
@@ -168,6 +183,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
 
 ```bash
+bootstack gallery                           # Launch the interactive widget gallery
 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-0.1.0a3 → bootstack-0.1.0a5}/README.md

@@ -10,9 +10,16 @@
 ![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
 
 
-**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+> **From the maker of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap).**
 
-The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+**bootstack** is a batteries-included desktop framework for Python, built on Tk.
+
+60+ themed widgets. Reactive state. Declarative layout. Built-in icons and localization. A CLI that scaffolds, builds, and ships. Everything ttkbootstrap was missing.
+
+<p align="center">
+  <img src="docs/assets/hero-demo-app-light.png" width="49%" alt="bootstack Data Analysis Workbench — light theme">
+  <img src="docs/assets/hero-demo-app-dark.png" width="49%" alt="bootstack Data Analysis Workbench — dark theme">
+</p>
 
 > **Active alpha.** APIs may change before the first stable release.
 > See the [documentation](https://bootstack.org) for guides and the API reference.
@@ -27,6 +34,14 @@ bootstack is currently in **active alpha**, so the `--pre` flag is required to o
 pip install --pre bootstack
 ```
 
+## 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
+```
+
 ## Quick Start
 
 ```python
@@ -102,7 +117,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 ## Features
 
 - **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
-- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **60+ themed widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
 - **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
 - **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
@@ -134,6 +149,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
 
 ```bash
+bootstack gallery                           # Launch the interactive widget gallery
 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-0.1.0a3 → bootstack-0.1.0a5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a3"
+version = "0.1.0a5"
 description = "A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -82,7 +82,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a3"
+current_version = "0.1.0a5"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)((?P<pre>a|b|rc)(?P<pre_n>\\d+))?"
 serialize = [
     "{major}.{minor}.{patch}{pre}{pre_n}",

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/cli/__init__.py

@@ -19,7 +19,7 @@ Usage:
     bootstack add i18n               Add i18n support
     bootstack list themes            List available themes
     bootstack doctor                 Diagnose project and environment health
-    bootstack demo                   Launch the widget demo
+    bootstack gallery                 Launch the widget gallery
 """
 
 from __future__ import annotations
@@ -49,7 +49,7 @@ Examples:
   bootstack add view SettingsView    Add a new view
   bootstack list themes              List available themes
   bootstack doctor                   Diagnose project and environment health
-  bootstack demo                     Launch the widget demo
+  bootstack gallery                  Launch the widget gallery
 
 For more information on a command:
   bootstack <command> --help
@@ -83,10 +83,17 @@ For more information on a command:
     list_cmd.add_parser(subparsers)
     doctor.add_parser(subparsers)
 
-    # Demo command (kept for backwards compatibility)
+    # Gallery command
+    gallery_parser = subparsers.add_parser(
+        "gallery",
+        help="Launch the widget gallery",
+    )
+    gallery_parser.set_defaults(func=lambda args: run_demo())
+
+    # demo is kept as a backwards-compatible alias
     demo_parser = subparsers.add_parser(
         "demo",
-        help="Launch the widget demo",
+        help=argparse.SUPPRESS,
     )
     demo_parser.set_defaults(func=lambda args: run_demo())
 

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/cli/demo.py

@@ -1,5 +1,5 @@
 """
-bootstack Widget Gallery
+Widget Gallery
 
 An AppShell-based showcase of bootstack widgets, organized by category
 to mirror the documentation structure. Each sidebar item opens a page
@@ -1170,7 +1170,7 @@ def _build_theme_page(page):
 def run_demo():
     """Run the bootstack widget gallery as an AppShell application."""
     shell = bs.AppShell(
-        title="bootstack Widget Gallery",
+        title="Widget Gallery",
         theme="bootstrap-light",
         size=(1100, 750),
     )
@@ -1261,7 +1261,7 @@ def setup_demo(master):
 
     bs.Label(
         master,
-        text="Use 'bootstack demo' to launch the full Widget Gallery.",
+        text="Use 'bootstack gallery' to launch the Widget Gallery.",
         font="heading-lg",
         padding=40,
     ).pack(fill=BOTH, expand=YES)

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/runtime/app.py

@@ -540,6 +540,16 @@ class App(BaseWindow, WidgetCapabilitiesMixin, tkinter.Tk):
         if self._hdpi:
             enable_high_dpi_awareness()
 
+        # Tell Windows this is a distinct app so the taskbar uses our icon
+        # instead of the generic python.exe icon.
+        if sys.platform == 'win32':
+            try:
+                import ctypes
+                app_id = f"bootstack.{(self.settings.app_name or 'app').lower().replace(' ', '.')}"
+                ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(app_id)
+            except Exception:
+                pass
+
         # Initialize Tk
         tkinter.Tk.__init__(self, **kwargs)
         self.withdraw()  # hide immediately until ready to show.

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/runtime/base_window.py

@@ -18,6 +18,7 @@ The BaseWindow mixin provides:
 
 from __future__ import annotations
 
+import sys
 import tkinter
 from typing import Literal, Optional, Tuple, Callable, Any
 
@@ -185,9 +186,25 @@ class BaseWindow:
             import pywinstyles
             pywinstyles.apply_style(self, window_style)
             self._window_style_applied = True
+            self.after(0, self._update_chrome_color)
+            self.bind('<<ThemeChanged>>', lambda e: self.after(0, self._update_chrome_color), add='+')
         except Exception:
             pass
 
+    def _update_chrome_color(self) -> None:
+        if getattr(self, '_updating_chrome', False):
+            return
+        self._updating_chrome = True
+        try:
+            import pywinstyles
+            from bootstack.style.style import get_theme_provider
+            color = get_theme_provider().colors['chrome']
+            pywinstyles.change_header_color(self, color)
+        except Exception:
+            pass
+        finally:
+            self._updating_chrome = False
+
     def _setup_alpha(self, alpha: float) -> None:
         """Configure window alpha transparency in a platform-aware manner.
 
@@ -229,40 +246,48 @@ class BaseWindow:
             On failure to load custom icon, falls back to default icon if enabled.
         """
         if iconphoto is None:
-            # No custom icon provided - use default if enabled
             if default_icon_enabled:
                 try:
                     from pathlib import Path
                     import bootstack
-                    icon_path = Path(bootstack.__file__).parent / 'assets' / 'bootstack.png'
-                    self._icon = tkinter.PhotoImage(file=str(icon_path), master=self)
-                    self.iconphoto(True, self._icon)
+                    assets = Path(bootstack.__file__).parent / 'assets'
+                    if sys.platform == 'win32':
+                        ico = assets / 'bootstack-light.ico'
+                        if not ico.exists():
+                            ico = assets / 'bootstack.ico'
+                        self.wm_iconbitmap(str(ico))
+                    else:
+                        self._icon = tkinter.PhotoImage(file=str(assets / 'bootstack.png'), master=self)
+                        self.iconphoto(True, self._icon)
                 except (ImportError, FileNotFoundError, tkinter.TclError, Exception):
-                    # Icon file not available or failed to load - silently continue
                     pass
             return
 
         # User provided a custom icon
         try:
-            # Check if it's already a PhotoImage object
             if isinstance(iconphoto, tkinter.PhotoImage):
                 self._icon = iconphoto
                 self.iconphoto(True, self._icon)
+            elif str(iconphoto).lower().endswith('.ico'):
+                self.wm_iconbitmap(str(iconphoto))
             else:
-                # Assume it's a file path
                 self._icon = tkinter.PhotoImage(file=iconphoto, master=self)
                 self.iconphoto(True, self._icon)
         except (tkinter.TclError, Exception) as e:
-            # Failed to load user icon
             print(f'Failed to load icon: {iconphoto} - {e}')
             if default_icon_enabled:
-                # Fall back to default bootstack.png
                 try:
                     from pathlib import Path
                     import bootstack
-                    icon_path = Path(bootstack.__file__).parent / 'assets' / 'bootstack.png'
-                    self._icon = tkinter.PhotoImage(file=str(icon_path), master=self)
-                    self.iconphoto(True, self._icon)
+                    assets = Path(bootstack.__file__).parent / 'assets'
+                    if sys.platform == 'win32':
+                        ico = assets / 'bootstack-light.ico'
+                        if not ico.exists():
+                            ico = assets / 'bootstack.ico'
+                        self.wm_iconbitmap(str(ico))
+                    else:
+                        self._icon = tkinter.PhotoImage(file=str(assets / 'bootstack.png'), master=self)
+                        self.iconphoto(True, self._icon)
                 except (ImportError, FileNotFoundError, tkinter.TclError, Exception):
                     pass
 

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/runtime/window_utilities.py

@@ -224,11 +224,18 @@ import bootstack.runtime.toplevel            >>> parent = tkinter.Tk()
         w_width = window.winfo_reqwidth()
         w_height = window.winfo_reqheight()
 
-        # Use virtual root for multi-monitor support
-        screen_x0 = window.winfo_vrootx()
-        screen_y0 = window.winfo_vrooty()
-        screen_width = window.winfo_vrootwidth()
-        screen_height = window.winfo_vrootheight()
+        # Use the monitor containing the proposed position when screeninfo is
+        # available — on Windows, winfo_vroot* only covers the primary monitor,
+        # so clamping with it moves windows that legitimately belong on a
+        # secondary monitor back onto the primary.
+        monitor = WindowPositioning._get_monitor_at_point(x, y)
+        if monitor:
+            screen_x0, screen_y0, screen_width, screen_height = monitor
+        else:
+            screen_x0 = window.winfo_vrootx()
+            screen_y0 = window.winfo_vrooty()
+            screen_width = window.winfo_vrootwidth()
+            screen_height = window.winfo_vrootheight()
 
         # Calculate screen boundaries
         screen_x1 = screen_x0 + screen_width

{bootstack-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack/widgets/composites/toast.py

@@ -311,7 +311,14 @@ class Toast:
 
         # ------ Positioning -------
 
-        # Update layout to get final window size
+        # Deiconify off-screen first so the geometry manager runs a full
+        # layout pass on a mapped window. winfo_height() returns 1 on a
+        # withdrawn window, causing the toast to be placed with ~0 height
+        # and therefore positioned flush against the screen edge.
+        top.deiconify()
+        top.geometry(
+            f"+{top.winfo_screenwidth() * 2}+{top.winfo_screenheight() * 2}"
+        )
         top.update_idletasks()
 
         # Apply positioning using WindowPositioning utilities

{bootstack-0.1.0a3 → bootstack-0.1.0a5/src/bootstack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a3
+Version: 0.1.0a5
 Summary: A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT
@@ -44,9 +44,16 @@ Dynamic: license-file
 ![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
 
 
-**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+> **From the maker of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap).**
 
-The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+**bootstack** is a batteries-included desktop framework for Python, built on Tk.
+
+60+ themed widgets. Reactive state. Declarative layout. Built-in icons and localization. A CLI that scaffolds, builds, and ships. Everything ttkbootstrap was missing.
+
+<p align="center">
+  <img src="docs/assets/hero-demo-app-light.png" width="49%" alt="bootstack Data Analysis Workbench — light theme">
+  <img src="docs/assets/hero-demo-app-dark.png" width="49%" alt="bootstack Data Analysis Workbench — dark theme">
+</p>
 
 > **Active alpha.** APIs may change before the first stable release.
 > See the [documentation](https://bootstack.org) for guides and the API reference.
@@ -61,6 +68,14 @@ bootstack is currently in **active alpha**, so the `--pre` flag is required to o
 pip install --pre bootstack
 ```
 
+## 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
+```
+
 ## Quick Start
 
 ```python
@@ -136,7 +151,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 ## Features
 
 - **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
-- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **60+ themed widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
 - **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
 - **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
@@ -168,6 +183,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
 
 ```bash
+bootstack gallery                           # Launch the interactive widget gallery
 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-0.1.0a3 → bootstack-0.1.0a5}/src/bootstack.egg-info/SOURCES.txt

@@ -25,6 +25,8 @@ src/bootstack/api/style.py
 src/bootstack/api/utils.py
 src/bootstack/api/widgets.py
 src/bootstack/assets/__init__.py
+src/bootstack/assets/bootstack-dark.ico
+src/bootstack/assets/bootstack-light.ico
 src/bootstack/assets/bootstack-transparent.png
 src/bootstack/assets/bootstack.ico
 src/bootstack/assets/bootstack.png