bootstack 0.4.5__tar.gz → 0.4.6__tar.gz

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

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.4.5"
+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.5"
+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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → 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.5 → bootstack-0.4.6/src/bootstack.egg-info}/PKG-INFO

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