bootstack 0.4.3__tar.gz → 0.4.5__tar.gz

{bootstack-0.4.3/src/bootstack.egg-info → bootstack-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.4.3
+Version: 0.4.5
 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

{bootstack-0.4.3 → bootstack-0.4.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.4.3"
+version = "0.4.5"
 description = "Build desktop GUI apps in pure Python and ship them as a standalone executable — built on Tk, no Tkinter boilerplate."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -114,7 +114,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.4.3"
+current_version = "0.4.5"
 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.4.3 → bootstack-0.4.5}/src/bootstack/_core/capture.py

@@ -223,9 +223,7 @@ def settle(tk_widget, seconds: float) -> None:
     real click re-enters the handler there — confirmed by hand, since a
     synthesized click cannot test this. Measured on Tk 8.6.17 in plain
     tkinter, so it is the toolkit rather than anything above it. X11 and Win32
-    map the window and are expected to honor it;
-    `development/probe_429_busy_during_settle.py` reports which a given box
-    does.
+    map the window and are expected to honor it.
 
     The wait dispatches either way. A correct picture is worth more than a
     stray click: without dispatching, the capture reads pixels that are simply

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/_runtime/toplevel.py

@@ -262,8 +262,7 @@ class Toplevel(BaseWindow, WidgetCapabilitiesMixin, tkinter.Toplevel):
         later `destroy()` is an ordinary path, and pairing on the blocking one
         alone would leave it unfixed. Measured before choosing it: the restore
         wins its race with Tk's own grab release, so `grab_current()` reads the
-        opener again once the dust settles
-        (`development/probe_444_grab_restore_ordering.py`).
+        opener again once the dust settles.
         """
         if self._grab_restore_bound:
             return

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/dialogs/_impl/datedialog.py

@@ -351,8 +351,7 @@ class DateDialog:
 
         Unlike `_confirm`, this releases no grab of its own. It does not need
         to: `Dialog` destroys the toplevel, and Tk releases a grab held by a
-        window when that window is destroyed (measured — see
-        `development/probe_437_review2_fixes.py`). `_confirm` keeps its
+        window when that window is destroyed (measured). `_confirm` keeps its
         `grab_release()` because it destroys the window itself, where the call
         is at least self-documenting.
         """

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/dialogs/_impl/dialog.py

@@ -211,9 +211,8 @@ def _key_was_consumed(widget: Any, keysym: str) -> bool:
 
     In both cases a DISABLED widget is the exception: its class binding runs
     but does nothing — `invoke` is a no-op on a disabled button, and
-    `tk::TextInsert` returns early on a disabled text (both measured,
-    `development/probe_441_key_already_handled.py`). Nothing answered the key,
-    so the default button should still get it. Standing down there would leave
+    `tk::TextInsert` returns early on a disabled text (both measured). Nothing
+    answered the key, so the default button should still get it. Standing down there would leave
     the keyboard dead for the whole dialog.
 
     ⚠ THE KEY MATTERS, NOT ONLY THE WIDGET — which is why `keysym` is required
@@ -712,7 +711,7 @@ class Dialog:
             # button from an input field -- but only where the window system
             # reports it separately, which is NOT everywhere. Measured with a
             # real keypress, alternating against the main Enter key as a
-            # control (`development/probe_441_kp_enter_platform.py`):
+            # control:
             #
             # * Windows FOLDS it into `Return` -- keysym `Return`, keycode 13,
             #   char `\r`, byte-identical to the main Enter key -- so this
@@ -752,8 +751,7 @@ class Dialog:
         documented as focusing its default button (issue #439).
 
         Waiting for the widget's own `<Map>` states that precondition instead
-        of guessing a delay. Measured on Windows
-        (`development/probe_439_focus_timing.py`): the button is still
+        of guessing a delay. Measured on Windows: the button is still
         unmapped once `deiconify()` AND `update_idletasks()` have both
         returned, so neither is a usable barrier. Asking after the toplevel is
         deiconified happens to work — Tk defers a request made against a

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/dialogs/_impl/query.py

@@ -169,8 +169,8 @@ class QueryDialog:
         # "ensure focus after dialog buttons set their own focus". Both ran
         # while the toplevel was still withdrawn, where `focus_set()` is a
         # silent no-op, so neither ever took and the entry was never actually
-        # focused — measured in `development/probe_439_default_button_focus.py`
-        # against pre-fix code, where focus sat on the toplevel. Handing the
+        # focused — measured against pre-fix code, where focus sat on the
+        # toplevel. Handing the
         # target to `Dialog` replaces the race with an ordering (issue #439).
         self._dialog._focus_target = getattr(entry, "entry_widget", entry)
 

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/i18n/README.md

@@ -52,7 +52,6 @@ Import path
 Contribution notes
 - Prefer base locales (`de`, `fr`, `nl`) unless region-specific differences are
   required (for example `pt_BR`).
-- Avoid embedding mnemonics `&` in messages; MessageCatalog strips them when rendering.
 - Keep message ids consistent (case and punctuation) to avoid duplicates.
 
 Minimum keys to translate for a new language (baseline UI):

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/i18n/msgcat.py

@@ -21,7 +21,7 @@ Public API (unchanged signatures):
 - MessageCatalog.set_many(locale, *args) -> int
 - MessageCatalog.max(*src) -> int
 - MessageCatalog.init(root=None, locales_dir=None, domain='messages',
-  default_locale='en', strip_ampersands=True) -> None
+  default_locale='en') -> None
 """
 
 from __future__ import annotations
@@ -47,7 +47,6 @@ class MessageCatalog:
     _domain: str = "messages"
     _locale: str = "en"
     _gt: gettext.NullTranslations | None = None
-    _strip_amp: bool = True
     _emit_event: bool = True
     _event_name: str = "<<LocaleChanged>>"
 
@@ -62,7 +61,6 @@ class MessageCatalog:
             locales_dir: Union[str, Path, None] = None,
             domain: str = "messages",
             default_locale: str = "en",
-            strip_ampersands: bool = True,
             emit_virtual_event: bool = True,
             virtual_event_name: str = "<<LocaleChanged>>",
     ) -> None:
@@ -75,7 +73,6 @@ class MessageCatalog:
                 directory is auto-discovered.
             domain: Gettext domain name.
             default_locale: Locale to activate after initialization.
-            strip_ampersands: If true, remove mnemonic `&` markers.
             emit_virtual_event: If true, generate a Tk virtual event after
                 locale changes so widgets can refresh themselves.
             virtual_event_name: The virtual event name to emit when the
@@ -87,7 +84,6 @@ class MessageCatalog:
 
         MessageCatalog._domain = domain
         MessageCatalog._locales_dir = Path(locales_dir) if locales_dir else MessageCatalog._discover_locales_dir()
-        MessageCatalog._strip_amp = strip_ampersands
         MessageCatalog._emit_event = bool(emit_virtual_event)
         MessageCatalog._event_name = str(virtual_event_name or "<<LocaleChanged>>")
         MessageCatalog._install_gettext(default_locale)
@@ -201,54 +197,6 @@ class MessageCatalog:
         parts = code.replace("-", "_").split("_")
         return parts[0].lower() if len(parts) == 1 else f"{parts[0].lower()}_{parts[1].lower()}"
 
-    @staticmethod
-    def __join(*args: Any) -> str:
-        """Join format args for Tcl msgcat formatting.
-
-        Args:
-            *args: Positional values to forward to Tcl 'format'.
-
-        Returns:
-            String of brace-wrapped arguments joined by spaces.
-        """
-        new_args = []
-        for arg in args:
-            if isinstance(arg, str):
-                stripped = str(arg).strip('"')
-                new_args.append("{%s}" % stripped)
-            else:
-                new_args.append(str(arg))
-        return " ".join(new_args)
-
-    @staticmethod
-    def _strip_ampersands(s: str) -> str:
-        """Remove mnemonic ampersands from text.
-
-        Converts single '&' markers to nothing and turns '&&' into a
-        literal '&'. Useful for rendering toolkit-agnostic text.
-
-        Args:
-            s: Input string.
-
-        Returns:
-            Cleaned string with mnemonic indicators removed.
-        """
-        if not s or "&" not in s:
-            return s
-        out = []
-        i = 0
-        while i < len(s):
-            if s[i] == "&":
-                if i + 1 < len(s) and s[i + 1] == "&":
-                    out.append("&")
-                    i += 2
-                else:
-                    i += 1  # skip mnemonic marker
-            else:
-                out.append(s[i])
-                i += 1
-        return "".join(out)
-
     # -------------- public API (unchanged signatures) ---------------------
 
     @staticmethod
@@ -279,16 +227,12 @@ class MessageCatalog:
         # work as in legacy behavior.
         cur = MessageCatalog._locale
         if fmtargs and cur in MessageCatalog._overrides and src in MessageCatalog._overrides[cur]:
-            command = f"::msgcat::mc {{{src}}} {MessageCatalog.__join(*fmtargs)}"
-            out = root.tk.eval(command)
-            return MessageCatalog._strip_ampersands(out) if MessageCatalog._strip_amp else out
+            return str(root.tk.call('::msgcat::mc', src, *fmtargs))
 
         # 1) overrides for current locale win first
         cur = MessageCatalog._locale
         if cur in MessageCatalog._overrides and src in MessageCatalog._overrides[cur]:
             s = MessageCatalog._overrides[cur][src]
-            if MessageCatalog._strip_amp:
-                s = MessageCatalog._strip_ampersands(s)
             # try Python formatting if args were passed; ignore on failure
             if fmtargs:
                 try:
@@ -306,8 +250,6 @@ class MessageCatalog:
                 # If gettext returns src unchanged, and we have no fmtargs,
                 # we'll consider falling back to msgcat for consistency.
                 if s != src:
-                    if MessageCatalog._strip_amp:
-                        s = MessageCatalog._strip_ampersands(s)
                     if fmtargs:
                         try:
                             return s % fmtargs
@@ -320,12 +262,8 @@ class MessageCatalog:
                 # ignore and fall back to msgcat
                 pass
 
-        # 3) Tcl msgcat fallback (preserves your current behavior exactly)
-        command = f"::msgcat::mc {{{src}}}"
-        if fmtargs:
-            command = f"{command} {MessageCatalog.__join(*fmtargs)}"
-        out = root.tk.eval(command)
-        return MessageCatalog._strip_ampersands(out) if MessageCatalog._strip_amp else out
+        # 3) Tcl msgcat fallback
+        return str(root.tk.call("::msgcat::mc", src, *fmtargs))
 
     @staticmethod
     def locale(new_locale: Optional[str] = None) -> str:
@@ -375,7 +313,7 @@ class MessageCatalog:
         msgs = Path(dirname).as_posix()
         from bootstack._runtime.app import get_default_root
         root = get_default_root()
-        return int(root.tk.eval(f"::msgcat::mcload [list {msgs}]"))
+        return int(root.tk.call('::msgcat::mcload', msgs))
 
     @staticmethod
     def set(locale: str, src: str, translated: Optional[str] = None) -> None:
@@ -390,7 +328,7 @@ class MessageCatalog:
         MessageCatalog._overrides.setdefault(loc, {})[src] = translated or ""
         from bootstack._runtime.app import get_default_root
         root = get_default_root()
-        root.tk.eval("::msgcat::mcset %s {%s} {%s}" % (MessageCatalog._to_msgcat_locale(locale), src, translated or ""))
+        root.tk.call('::msgcat::mcset', MessageCatalog._to_msgcat_locale(locale), src, translated or "")
 
     @staticmethod
     def set_many(locale: str, *args: str) -> int:
@@ -414,12 +352,10 @@ class MessageCatalog:
         # update Tcl msgcat
         from bootstack._runtime.app import get_default_root
         root = get_default_root()
-        messages = " ".join(["{%s}" % x for x in args])
-        out = f"::msgcat::mcmset {MessageCatalog._to_msgcat_locale(locale)} {{{messages}}}"
-        return int(root.tk.eval(out))
+        return int(root.tk.call("::msgcat::mcmset", MessageCatalog._to_msgcat_locale(locale), tuple(args)))
 
     @staticmethod
     def max(*src: str) -> int:
         from bootstack._runtime.app import get_default_root
         root = get_default_root()
-        return int(root.tk.eval(f"::msgcat::mcmax {' '.join(src)}"))
+        return int(root.tk.call("::msgcat::mcmax", *src))

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_core/navmodel.py

@@ -14,8 +14,6 @@ The model encodes two design invariants:
 - The rail (workspace switcher) renders only when there is more than one
   workspace, so a single-tier app is the degenerate one-workspace case with no
   branching in the consumer.
-
-See `development/appshell-navigation-spec.md` for the full design.
 """
 
 from __future__ import annotations

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_impl/composites/contextmenu.py

@@ -210,6 +210,20 @@ class _ToplevelContextMenu(CustomConfigMixin):
         # Setup keyboard bindings
         self._setup_keyboard_bindings()
 
+        # hide the menu when the app loses focus
+        self._toplevel.bind("<FocusOut>", self._on_focus_out, add="+")
+
+    def _on_focus_out(self, _):
+        root = self._toplevel._root()
+        root.after_idle(self._hide_if_app_lost_focus)
+
+    def _hide_if_app_lost_focus(self):
+        try:
+            if self._toplevel.winfo_viewable() and self._toplevel.focus_get() is None:
+                self.hide()
+        except (TclError, KeyError):  # destroyed; focus_get() raises KeyError for Tcl-created window
+            pass
+
     def _generate_key(self) -> str:
         """Generate an auto key for an item."""
         key = f"item_{self._counter}"

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_impl/composites/menu/__init__.py

@@ -3,8 +3,6 @@
 A single platform-neutral menu *model* (`MenuModel` / `MenuGroup` / `MenuItem`)
 is the source of truth; platform renderers consume it — a themed in-window strip
 on Windows/Linux and the native global menu bar on macOS.
-
-See `docs/_dev/menu-redesign.md` for the design.
 """
 from __future__ import annotations
 

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_impl/composites/selectbox.py

@@ -948,6 +948,18 @@ class SelectBox(Field):
         tab_binding = self.entry_widget.bind('<Tab>', on_tab)
         popup_state['key_bindings'].append(('<Tab>', tab_binding))
 
+        def _hide_if_app_lost_focus():
+            if popup_state['popup_closed']:
+                return
+            try:
+                if toplevel.winfo_viewable() and self.focus_get() is None:
+                    close_popup()
+            except (TclError, KeyError):  # destroyed; focus_get() raises KeyError for a Tcl-created window
+                pass
+
+        focusout_binding = self.entry_widget.bind('<FocusOut>', lambda e: self._root().after_idle(_hide_if_app_lost_focus), add="+")
+        popup_state['key_bindings'].append(('<FocusOut>', focusout_binding))
+
         # Setup click-outside detection
         def on_root_click(event):
             x, y = event.x_root, event.y_root

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_impl/composites/shell/__init__.py

@@ -1,6 +1,6 @@
 """Internal composites for the clean-slate application shell.
 
-Layered per `docs/_dev/appshell-navigation-spec.md`:
+Layered as:
 
 - `layout.ShellLayout` — Layer 1, the dumb region/slot band layout.
 - `nav_panel.NavPanel` — the static single-select nav list (sidebar).

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/_impl/composites/shell/layout.py

@@ -23,14 +23,14 @@ only the body row knows whether the rail/sidebar/dock exist. That invariant lets
 "sidebar + chrome", "chrome only", and "sidebar only" be the same layout with
 slots toggled rather than separate code paths.
 
-Note: the resizable sidebar/content sash (a `PanedWindow`) is deferred to the
-collapse step — for now the body uses fixed-width pack slots. See the build order
-in `docs/_dev/appshell-navigation-spec.md`.
+Note: the body uses fixed-width pack slots; a resizable sidebar/content sash
+(a `PanedWindow`) is not built.
 """
 
 from __future__ import annotations
 
 import sys
+from tkinter import TclError
 from typing import Any
 
 from bootstack._runtime.app import App
@@ -128,6 +128,7 @@ class ShellLayout(App):
         self._show_rail = False
         self._show_sidebar = True
         self._show_dock = False
+        self._recolor_pending = False
 
         self._build_regions()
         self._relayout_window()
@@ -206,6 +207,7 @@ class ShellLayout(App):
             self._status_sep.pack(side="bottom", fill="x")
         # Body fills whatever the bands leave; packed last so it claims the middle.
         self._body.pack(side="top", fill="both", expand=True)
+        self._recolor_show_slots()
 
     def _relayout_body(self) -> None:
         """Re-pack the rail / sidebar / content / dock slots left-to-right."""
@@ -221,6 +223,35 @@ class ShellLayout(App):
         self._content.pack(side="left", fill="both", expand=True)
         if self._show_dock:
             self._dock.pack(side="right", fill="y")
+        self._recolor_show_slots()
+
+    def _recolor_show_slots(self):
+        """Repaint slots that just became visible after a theme change"""
+        if self._recolor_pending:
+            return
+        self._recolor_pending = True
+
+        def _recolor():
+            self._recolor_pending = False
+            from bootstack.style.style import get_style
+            style = get_style()
+            shown = [self._content]
+            if self._show_rail:
+                shown.append(self._rail)
+            if self._show_sidebar:
+                shown.append(self._sidebar)
+            if self._show_statusbar:
+                shown.append(self._statusbar)
+            for slot in shown:
+                try:
+                    style.apply_theme_walk(slot, only_stale=True)
+                except TclError:
+                    pass # destroyed between relayout and the idle callback
+
+        try:
+            self.after_idle(_recolor)
+        except (TclError, AttributeError):
+            pass
 
     # ----- Region sizing -----
 

{bootstack-0.4.3 → bootstack-0.4.5}/src/bootstack/widgets/select.py

@@ -92,8 +92,7 @@ class Select(ValueSignalMixin, FieldAddonMixin, PublicWidgetBase):
     # a decoupled option list hands the rule that option's real object -- and a
     # `range` rule over numeric or date option values works. Declaring the
     # mixin's `'text'` default here would reject it at attach time and break
-    # code that runs today; measured both ways in
-    # `development/probe_465_select_range_kind.py`.
+    # code that runs today; measured both ways.
     _VALIDATION_KIND: str | None = None
 
     def __init__(

{bootstack-0.4.3 → bootstack-0.4.5/src/bootstack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.4.3
+Version: 0.4.5
 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