bootstack 0.4.4__tar.gz → 0.4.6__tar.gz

{bootstack-0.4.4/src/bootstack.egg-info → bootstack-0.4.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.4.4
+Version: 0.4.6
 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.4 → bootstack-0.4.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.4.4"
+version = "0.4.6"
 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.4"
+current_version = "0.4.6"
 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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/src/bootstack/_runtime/app.py

@@ -135,6 +135,10 @@ def apply_class_bindings(window: tkinter.Widget | App) -> None:
                 sequence=sequence,
                 func=on_select_all)
 
+    for sequence in window.bind_class("TSpinbox"):
+        if any(s in sequence for s in ("Wheel", "Button-4", "Button-5", "Touchpad")):
+            window.unbind_class("TSpinbox", sequence)
+
     window.unbind_class("TButton", "<Key-space>")
 
     def button_default_binding(event: tkinter.Event) -> None:

{bootstack-0.4.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/src/bootstack/_runtime/wheel.py

@@ -46,6 +46,12 @@ def has_touchpad_scroll() -> bool:
     """Whether the running Tk generates `<TouchpadScroll>` events."""
     return tk.TkVersion >= _TOUCHPAD_TK
 
+def has_focus(widget: tk.Misc) -> bool:
+    """Whether `widget` holds keyboard focus in its application"""
+    try:
+        return widget.focus_get() is widget
+    except (tk.TclError, KeyError):
+        return False
 
 def uses_x11_buttons(widget: tk.Misc) -> bool:
     """Whether wheel input arrives as `<Button-4>`/`<Button-5>` here.

{bootstack-0.4.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/_parts/numberentry_part.py

@@ -29,7 +29,7 @@ class NumberEntryPart(TextEntryPart):
             master=None,
             *,
             value: int | float | str = 0,
-            value_format: str = None,
+            value_format: str | None = None,
             minvalue: int | float | None = None,
             maxvalue: int | float | None = None,
             increment: int | float = 1,
@@ -142,9 +142,9 @@ class NumberEntryPart(TextEntryPart):
         return 'break'  # Prevent default behavior
 
     def _handle_mouse_wheel(self, event):
-        """Handle a wheel notch by stepping the value once."""
-        if not self._is_interactive():
-            return 'break'
+        """Step once per wheel notch while the field has focus"""
+        if not wheel.has_focus(self) or not self._is_interactive():
+            return None
         notches = wheel.wheel_notches(self, event)
         if notches:
             name = '<<Increment>>' if notches > 0 else '<<Decrement>>'
@@ -157,8 +157,8 @@ class NumberEntryPart(TextEntryPart):
         A trackpad reports around sixty events a second; stepping on each
         one would run the value away from the user.
         """
-        if not self._is_interactive():
-            return 'break'
+        if not wheel.has_focus(self) or not self._is_interactive():
+            return None
         _dx, dy = wheel.precise_deltas(event)
         _sx, steps = self._touchpad.add(0, dy, 1, _TOUCHPAD_STEP_PX)
         name = '<<Increment>>' if steps > 0 else '<<Decrement>>'

{bootstack-0.4.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/composites/numericentry.py

@@ -4,15 +4,18 @@ Provides a specialized entry field for numeric input with increment/decrement
 buttons and keyboard/mouse wheel support.
 """
 
-from typing import Any, Callable
+from typing import Any, Callable, cast, TYPE_CHECKING
 from tkinter import TclError
 from typing_extensions import Unpack
 
 from bootstack.widgets._impl.primitives.button import Button
 from bootstack.widgets._impl.composites.field import Field, FieldOptions
+
 from bootstack.widgets._impl.mixins import configure_delegate
 from bootstack.widgets.types import Master
 
+if TYPE_CHECKING:
+    from bootstack.widgets._impl._parts import NumberEntryPart
 
 class NumericEntry(Field):
     """A numeric entry field widget with increment/decrement spin buttons.
@@ -21,12 +24,14 @@ class NumericEntry(Field):
     keyboard stepping (Up/Down arrows), mouse wheel support, and optional wrapping.
     """
 
+    entry_widget: "NumberEntryPart"
+
     def __init__(
             self,
             master: Master = None,
             value: int | float = 0,
-            label: str = None,
-            message: str = None,
+            label: str | None = None,
+            message: str | None = None,
             show_spin_buttons: bool = True,
             minvalue: int | float | None = None,
             maxvalue: int | float | None = None,
@@ -80,8 +85,8 @@ class NumericEntry(Field):
         self._show_spin_buttons = show_spin_buttons
 
         # pack info
-        self._increment_pack_info = {}
-        self._decrement_pack_info = {}
+        self._increment_pack_info: Any = {}
+        self._decrement_pack_info: Any = {}
 
         # buttons
         self.insert_addon(
@@ -96,12 +101,12 @@ class NumericEntry(Field):
     @property
     def increment_widget(self) -> Button:
         """Get the increment spin button widget."""
-        return self.addons['increment']
+        return cast(Button, self.addons['increment'])
 
     @property
     def decrement_widget(self) -> Button:
         """Get the decrement spin button widget."""
-        return self.addons['decrement']
+        return cast(Button, self.addons['decrement'])
 
     def increment(self) -> None:
         """Increment the numeric value by one step."""
@@ -182,7 +187,7 @@ class NumericEntry(Field):
                 pass
 
     @configure_delegate('show_spin_buttons')
-    def _delegate_show_spin_buttons(self, value: bool = None):
+    def _delegate_show_spin_buttons(self, value: bool | None = None):
         """Get or set the visibility of spin buttons."""
         if value is None:
             return self._show_spin_buttons

{bootstack-0.4.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/composites/tabs/tabitem.py

@@ -113,9 +113,7 @@ class TabItem(CompositeFrame):
         self._close_button: Button | None = None
 
         self._build_widget(accent, surface)
-
-        if self._min_width:
-            self.after_idle(self._apply_min_width)
+        self._schedule_min_width()
 
         # Set up signal/variable after widget is built
         if signal is not None:
@@ -137,6 +135,14 @@ class TabItem(CompositeFrame):
             self.pack_propagate(False)
             self.configure(width=self._min_width, height=self.winfo_reqheight())
 
+    def _schedule_min_width(self):
+        """Re-measure the minimum width once the current content has laid out"""
+        if not self._min_width:
+            return
+        self.pack_propagate(True)
+        self.configure(width=0, height=0)
+        self.after_idle(self._apply_min_width)
+
     def _on_destroy(self, event=None):
         """Clean up variable trace when widget is destroyed."""
         if event.widget is not self:
@@ -310,6 +316,7 @@ class TabItem(CompositeFrame):
         self._text = value
         if self._label is not None:
             self._label.configure(text=value)
+            self._schedule_min_width()
         return None
 
     @configure_delegate('icon')
@@ -320,6 +327,7 @@ class TabItem(CompositeFrame):
         self._icon = value
         if self._label is not None:
             self._label.configure(icon=value)
+            self._schedule_min_width()
         return None
 
     @configure_delegate('compound')
@@ -330,6 +338,7 @@ class TabItem(CompositeFrame):
         self._compound = value
         if self._label is not None:
             self._label.configure(compound=value)
+            self._schedule_min_width()
         return None
 
     @configure_delegate('value')
@@ -370,6 +379,7 @@ class TabItem(CompositeFrame):
                 self._close_button.place_forget()
                 self._close_button.destroy()
                 self._close_button = None
+            self._schedule_min_width()
         return None
 
     @configure_delegate('signal')

{bootstack-0.4.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/composites/textarea/extensions/smart_indent.py

@@ -45,7 +45,10 @@ class SmartIndent(EditFilter):
         core.text.bind("<Return>", self._on_return, add="+")
         core.text.bind("<Tab>", self._on_tab, add="+")
         core.text.bind("<Shift-Tab>", self._on_shift_tab, add="+")
-        core.text.bind("<ISO_Left_Tab>", self._on_shift_tab, add="+")  # Linux/X11
+
+        # X11 reports Shift+Tab as ISO_Left_Tab; other Tk builds may reject the keysym
+        if core.winsys == "x11":
+            core.text.bind("<ISO_Left_Tab>", self._on_shift_tab, add="+")
 
     def detach(self, core: _MultilineCore) -> None:
         self._core = None

{bootstack-0.4.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/composites/textarea/textarea.py

@@ -173,7 +173,10 @@ class TextArea(GridFrame):
         # it is a separate composite and is unaffected.)
         self._core.text.bind("<Tab>", self._focus_next, add="+")
         self._core.text.bind("<Shift-Tab>", self._focus_prev, add="+")
-        self._core.text.bind("<ISO_Left_Tab>", self._focus_prev, add="+")
+
+        # X11 reports Shift+Tab as ISO_Left_Tab; other Tk builds may reject the keysym
+        if self._core.winsys == "x11":
+            self._core.text.bind("<ISO_Left_Tab>", self._focus_prev, add="+")
 
         # ── message label (row 2) ─────────────────────────────────────────
         self._message_lbl = Label(self, text=message or "", font="caption",

{bootstack-0.4.4 → bootstack-0.4.6}/src/bootstack/widgets/_impl/primitives/spinbox.py

@@ -72,9 +72,7 @@ class Spinbox(TextSignalMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkState
             kwargs['font'] = 'caption'
         kwargs.update(style_options=self._capture_style_options(['density'], kwargs))
         super().__init__(master, **kwargs)
-        # Handle mousewheel explicitly so we can return "break" and stop the
-        # event from leaking to parent scroll containers. Instance bindings run
-        # before class bindings in Tk's chain, so we must do the spin ourselves.
+
         for seq in wheel.wheel_sequences(self):
             self.bind(seq, self._on_mousewheel)
         if wheel.has_touchpad_scroll():
@@ -82,6 +80,8 @@ class Spinbox(TextSignalMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkState
             self.bind(wheel.TOUCHPAD_SCROLL, self._on_touchpad_scroll)
 
     def _on_mousewheel(self, event):
+        if not wheel.has_focus(self):
+            return None
         notches = wheel.wheel_notches(self, event)
         if notches:
             self.event_generate("<Up>" if notches > 0 else "<Down>")
@@ -93,6 +93,8 @@ class Spinbox(TextSignalMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkState
         A trackpad reports around sixty events a second; stepping on each
         one would run the value away from the user.
         """
+        if not wheel.has_focus(self):
+            return None
         _dx, dy = wheel.precise_deltas(event)
         _sx, steps = self._touchpad.add(0, dy, 1, _TOUCHPAD_STEP_PX)
         for _ in range(abs(steps)):

{bootstack-0.4.4 → bootstack-0.4.6}/src/bootstack/widgets/numberfield.py

@@ -14,6 +14,8 @@ from bootstack.widgets.types import AccentToken, Event, Justify, WidgetDensity
 
 if TYPE_CHECKING:
     from bootstack.signals import Signal
+    from bootstack.widgets._impl.composites.numericentry import NumericEntry
+
 
 def _as_number(raw: Any) -> int | float | None:
     """Coerce a field's stored value to a number, regardless of representation.
@@ -48,8 +50,8 @@ class NumberField(ValueSignalMixin, FieldAddonMixin, PublicWidgetBase):
     """A numeric input field with optional stepper buttons.
 
     Accepts integer or float values. Up/Down arrow keys and the mouse wheel
-    step the value by `step`. The field validates that the typed value is
-    numeric and within `min_value`/`max_value` bounds.
+    step the value by `step` while the field has focus. The field validates
+    that the typed value is numeric and within `min_value`/`max_value` bounds.
 
     The initial value is the first positional argument. All options are
     keyword-only.
@@ -131,7 +133,7 @@ class NumberField(ValueSignalMixin, FieldAddonMixin, PublicWidgetBase):
         layout_kw = self._split_layout_kwargs(kwargs)
         tk_master = self._parent._child_master() if self._parent else None
 
-        internal_kwargs: dict[str, Any] = {
+        internal_kwargs: Any = {
             "value": value,
             "increment": step,
             "show_spin_buttons": show_steppers,
@@ -165,7 +167,7 @@ class NumberField(ValueSignalMixin, FieldAddonMixin, PublicWidgetBase):
         if density is not None:
             internal_kwargs["density"] = density
 
-        self._internal = _InternalNumericEntry(tk_master, **internal_kwargs)
+        self._internal: "NumericEntry" = _InternalNumericEntry(tk_master, **internal_kwargs)
         self._attach_to_parent(layout_kw)
 
         if signal is not None:

{bootstack-0.4.4 → bootstack-0.4.6}/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.4 → bootstack-0.4.6/src/bootstack.egg-info}/PKG-INFO

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