bootstack 0.4.5__tar.gz → 0.4.7__tar.gz

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

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.4.5"
+version = "0.4.7"
 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.7"
 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.7}/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.7}/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.7}/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.7}/src/bootstack/widgets/_impl/composites/contextmenu.py

@@ -4,6 +4,7 @@ Provides a customizable context menu with support for commands, checkbuttons,
 radiobuttons, and separators.
 """
 
+import weakref
 from tkinter import BooleanVar, IntVar, Misc, StringVar, TclError, Toplevel, Widget
 from typing_extensions import Unpack
 from typing import Any, Callable, Literal
@@ -42,6 +43,23 @@ On Windows and Linux the result is the created widget. On macOS (native
 # explicitly" (no target — no positioning, no auto-trigger).
 _TARGET_DEFAULT: Any = object()
 
+# Themed menus currently shown. Weak, so a new menu torn down with its parent
+# is not pinned here (it's destroy()) is never called.
+_OPEN_MENUS: "weakref.WeakSet[_ToplevelContextMenu]" = weakref.WeakSet()
+
+
+def hide_open_menus() -> None:
+    """Hide every open themed context menu.
+
+    Call this from a click handler that returns 'break': the break stops the
+    click before the window-level outside-click handler can close the menu.
+    """
+    for menu in list(_OPEN_MENUS):
+        try:
+            menu.hide()
+        except TclError:
+            _OPEN_MENUS.discard(menu)
+
 
 class _CommandItemFrame(CompositeFrame):
     """Container frame for command items that delegates to the inner button.
@@ -648,6 +666,7 @@ class _ToplevelContextMenu(CustomConfigMixin):
         self._toplevel.attributes('-topmost', True)
         self._toplevel.lift()
         self._toplevel.focus_force()
+        _OPEN_MENUS.add(self)
 
         # Start with no item highlighted (keyboard nav will highlight on first arrow key)
         self._highlighted_index = -1
@@ -737,6 +756,7 @@ class _ToplevelContextMenu(CustomConfigMixin):
 
     def hide(self) -> None:
         """Hide the context menu."""
+        _OPEN_MENUS.discard(self)
         # Unbind click handler first
         self._cancel_click_outside_after()
         self._unbind_click_outside_handler()
@@ -756,6 +776,7 @@ class _ToplevelContextMenu(CustomConfigMixin):
 
     def destroy(self) -> None:
         """Destroy the context menu and cleanup resources."""
+        _OPEN_MENUS.discard(self)
         # Unbind click handler
         self._cancel_click_outside_after()
         self._unbind_click_outside_handler()

{bootstack-0.4.5 → bootstack-0.4.7}/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.7}/src/bootstack/widgets/_impl/composites/selectbox.py

@@ -391,7 +391,48 @@ class SelectBox(Field):
         text = self.entry_widget.get()
         if text in self._value_by_text and self._value_by_text[text] != text:
             return self._value_by_text[text]
-        return self._entry_live_validation_value()
+        return self._decode_custom_text(text, self._entry_live_validation_value)
+
+    def _numeric_option_kind(self):
+        """`int` or `float` when every option value shares that type, else None."""
+        # type(), not isinstance: bool never reads as int here, so a bool option
+        # list falls out as "not numeric" without a special case.
+        kinds = {type(rec.value) for rec in self._records}
+        if len(kinds) != 1:
+            return None
+        kind = kinds.pop()
+        return kind if kind in (int, float) else None
+
+    def _decode_custom_text(self, text, fallback):
+        """Decode text that names no option: the options' own type when they share one.
+
+        A value typed by the user arrives as text with nothing to parse it,
+        while one assigned from code arrives already typed. When every option
+        value is an `int`, or every one a `float`, numeric text is parsed to
+        that type so both routes agree. Anything else — a mixed or empty
+        list, `str` or `bool` options, text that is not a number, an entry
+        that parses through its own `value_format` — is handed to `fallback`,
+        which is what the entry reported before.
+
+        A whole-number `float` narrows to `int` for `int` options; `'6.5'`
+        against `int` options stays `6.5` rather than being truncated.
+        """
+        if self.entry_widget._value_format is not None:
+            return fallback()
+        if getattr(self.entry_widget, "_showing_placeholder", False):
+            return fallback()
+        kind = self._numeric_option_kind()
+        if kind is None:
+            return fallback()
+        try:
+            parsed = self.entry_widget._fmt.parse(text, "decimal")
+        except ValueError:
+            return fallback()
+        if parsed is None:
+            return fallback()
+        if kind is int and not parsed.is_integer():
+            return parsed
+        return kind(parsed)
 
     def _register_retired_value(self, value: Any) -> None:
         """Make a value that is not in the option list decodable.
@@ -1185,16 +1226,17 @@ class SelectBox(Field):
         """The selected value, or None when the field is empty.
 
         For a decoupled option (its display text differs from its value) this
-        returns the option's value. Otherwise it returns the entry's own raw
-        value, so `value_format` parsing — e.g. TimeField's `datetime.time` —
-        is preserved.
+        returns the option's value. A custom value typed by the user takes the
+        type the options share when that is `int` or `float`. Otherwise it
+        returns the entry's own raw value, so `value_format` parsing — e.g.
+        TimeField's `datetime.time` — is preserved.
         """
         text = self.entry_widget.get()
         if text == "":
             return None
         if text in self._value_by_text and self._value_by_text[text] != text:
             return self._value_by_text[text]
-        return Field.value.fget(self)
+        return self._decode_custom_text(text, lambda: Field.value.fget(self))
 
     @value.setter
     def value(self, value):

{bootstack-0.4.5 → bootstack-0.4.7}/src/bootstack/widgets/_impl/composites/tableview/tableview.py

@@ -30,7 +30,7 @@ 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, debug_log_exception
-from bootstack.widgets._impl.composites.contextmenu import ContextMenu
+from bootstack.widgets._impl.composites.contextmenu import ContextMenu, hide_open_menus
 from bootstack.widgets._impl.composites.tooltip import ToolTip
 from bootstack.widgets._impl.composites.dropdownbutton import DropdownButton
 from bootstack.widgets._impl.primitives.entry import Entry
@@ -1644,6 +1644,7 @@ class TableView(Frame):
     # ------------------------------------------------------------------ Row context menu
     def _dismiss_context_menus(self) -> None:
         """Hide any open built-in row/header context menu (idempotent)."""
+        hide_open_menus()
         for menu in (self._row_menu, self._header_menu):
             if menu is not None:
                 try:

{bootstack-0.4.5 → bootstack-0.4.7}/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.7}/src/bootstack/widgets/_impl/composites/textarea/core.py

@@ -524,26 +524,15 @@ class _MultilineCore(tk.Frame):
 
     # ── convenience: forward common Text API to self ──────────────────────
 
-    def bind(self, sequence=None, func=None, add=None):
-        return self.text.bind(sequence, func, add)
-
-    def unbind(self, sequence, funcid=None):
-        return self.text.unbind(sequence, funcid)
-
     def focus_set(self):
         self.text.focus_set()
 
     # ── cleanup ───────────────────────────────────────────────────────────
 
     def _on_destroy(self, event: tk.Event) -> None:
-        # Released for any Destroy in this subtree, not just our own: the event
-        # this handler receives names the inner Text, never the core, so gating
-        # the release on `is self` releases nothing and the subscription outlives
-        # the widget. The rest of the block stays behind the guard -- it has
-        # never run, and starting it here is not this change's business.
-        self._unbind_signal()
         if event.widget is not self:
             return
+        self._unbind_signal()
         self._chain.destroy()
         try:
             for seq in wheel.wheel_sequences(self):

{bootstack-0.4.5 → bootstack-0.4.7}/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.7}/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.7}/src/bootstack/widgets/_impl/composites/tree/treeitem.py

@@ -14,6 +14,7 @@ from tkinter import TclError
 from typing import Any, Optional
 
 from bootstack.widgets._impl.composites.compositeframe import CompositeFrame
+from bootstack.widgets._impl.composites.contextmenu import hide_open_menus
 from bootstack.widgets._impl.primitives.button import Button
 from bootstack.widgets._impl.primitives.frame import Frame
 from bootstack.widgets._impl.primitives.label import Label
@@ -193,6 +194,9 @@ class TreeItem(CompositeFrame):
             self._emit("<<TreeItemSelect>>", self._node)
 
     def _on_ctrl_click(self, event=None) -> str:
+        # The 'break' below stops the click before an open menu's outside-click
+        # handler sees it, so close the open menus here
+        hide_open_menus()
         if self._node is not None:
             if self._focusable:
                 self.focus()
@@ -209,6 +213,9 @@ class TreeItem(CompositeFrame):
         return "break"
 
     def _on_right_click(self, event) -> str:
+        # The 'break' below stops the click before an open menu's outside-click
+        # handler sees it, so close open menus before this row opens its own
+        hide_open_menus()
         if self._node is not None:
             self._emit(
                 "<<TreeItemRightClick>>",

{bootstack-0.4.5 → bootstack-0.4.7}/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.7}/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.7}/src/bootstack/widgets/select.py

@@ -50,7 +50,11 @@ class Select(ValueSignalMixin, FieldAddonMixin, PublicWidgetBase):
         searchable: If `True`, typing in the field filters the option
             list. Defaults to `False`.
         allow_custom_values: If `True`, users may type values not in
-            `options`. Defaults to `False`.
+            `options`. A typed value takes the type the option values share:
+            when every option value is an `int`, or every one a `float`,
+            numeric text is read as that type; otherwise, and for text that
+            is not a number, the value is the text as typed. Defaults to
+            `False`.
         group_by: Name of an option field to cluster the popup rows under
             non-selectable group headers (e.g. `'category'`). The field is read
             from each option's flat record, so it may be any carried bag key (or

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

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