bootstack 0.4.2__tar.gz → 0.4.4__tar.gz

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

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.4.2"
+version = "0.4.4"
 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.2"
+current_version = "0.4.4"
 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.2 → bootstack-0.4.4}/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.2 → bootstack-0.4.4}/src/bootstack/widgets/_impl/composites/pathentry.py

@@ -5,7 +5,6 @@ from typing import Any, Literal
 
 from typing_extensions import Unpack
 
-from bootstack.events import ChangeEvent
 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
@@ -62,7 +61,6 @@ class PathEntry(Field):
         self._default_extension = default_extension
         self._default_filename = default_filename
         self._dialog_result = None
-        self._prev_value: str | None = value
 
         super().__init__(master=master, label=label, message=message, value=value, **kwargs)
 
@@ -154,15 +152,5 @@ class PathEntry(Field):
             display_text = result
 
         if result:
-            prev_value = self._prev_value
-            self._prev_value = display_text
             self.value = display_text
-            self.event_generate(
-                '<<Change>>',
-                data=ChangeEvent(
-                    value=display_text,
-                    prev_value=prev_value,
-                    text=display_text,
-                ),
-                when="tail"
-            )
+            self._entry._check_if_changed()

{bootstack-0.4.2 → bootstack-0.4.4}/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.2 → bootstack-0.4.4}/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.2 → bootstack-0.4.4}/src/bootstack/widgets/_impl/composites/slider/rangeslider.py

@@ -716,27 +716,29 @@ class RangeSlider(ConfigureDelegationMixin, tk.Frame):
         self._sync()
         lo = self._lo_var.get()
         hi = self._hi_var.get()
-        self.event_generate("<<Change>>", data=RangeSliderEvent(
-            low_value=lo,
-            high_value=hi,
-            prev_low_value=self._prev_lovalue,
-            prev_high_value=self._prev_hivalue,
-        ))
-        self._prev_lovalue = lo
-        self._prev_hivalue = hi
+        if hi != self._prev_hivalue or lo != self._prev_lovalue:
+            self.event_generate("<<Change>>", data=RangeSliderEvent(
+                low_value=lo,
+                high_value=hi,
+                prev_low_value=self._prev_lovalue,
+                prev_high_value=self._prev_hivalue,
+            ))
+            self._prev_lovalue = lo
+            self._prev_hivalue = hi
 
     def _on_hi_write(self, *_: Any) -> None:
         self._sync()
         lo = self._lo_var.get()
         hi = self._hi_var.get()
-        self.event_generate("<<Change>>", data=RangeSliderEvent(
-            low_value=lo,
-            high_value=hi,
-            prev_low_value=self._prev_lovalue,
-            prev_high_value=self._prev_hivalue,
-        ))
-        self._prev_lovalue = lo
-        self._prev_hivalue = hi
+        if lo != self._prev_lovalue or hi != self._prev_hivalue:
+            self.event_generate("<<Change>>", data=RangeSliderEvent(
+                low_value=lo,
+                high_value=hi,
+                prev_low_value=self._prev_lovalue,
+                prev_high_value=self._prev_hivalue,
+            ))
+            self._prev_lovalue = lo
+            self._prev_hivalue = hi
 
     def _on_map(self) -> None:
         if getattr(self, '_theme_update_pending', False):

{bootstack-0.4.2 → bootstack-0.4.4}/src/bootstack/widgets/_impl/composites/slider/slider.py

@@ -579,8 +579,9 @@ class Slider(ConfigureDelegationMixin, tk.Frame):
     def _on_var_write(self, *_: Any) -> None:
         self._sync()
         val = self._var.get()
-        self.event_generate("<<Change>>", data=SliderEvent(value=val, prev_value=self._prev_value))
-        self._prev_value = val
+        if val != self._prev_value:
+            self.event_generate("<<Change>>", data=SliderEvent(value=val, prev_value=self._prev_value))
+            self._prev_value = val
 
     def _mouse_focus_set(self, _event: tk.Event) -> None:
         self._mouse_pressed = True

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

@@ -114,6 +114,9 @@ class TextArea(GridFrame):
         self._valid_signal: Signal = Signal(True)
         self._error_signal: Signal = Signal("")
 
+        self._prev_changed_value = value
+        self._prev_input_text = value
+
         # ── label (row 0) ─────────────────────────────────────────────────
         if label:
             _lbl_text = f"{label} *" if required else label
@@ -192,6 +195,7 @@ class TextArea(GridFrame):
         self._core._signal_text_sink = lambda text: setattr(self, "value", text)
         if textsignal is not None:
             self._core.bind_signal(textsignal)
+        self._prev_input_text = self.value
 
         # ── placeholder ───────────────────────────────────────────────────
         self._default_fg = self._core.text.cget("foreground")
@@ -223,6 +227,7 @@ class TextArea(GridFrame):
         # Fire <<Input>> on every edit, <<Changed>> + validation on blur.
         self._core.text.bind("<<Change>>", self._on_core_change, add="+")
         self._core.text.bind("<FocusOut>", self._on_focus_out, add="+")
+        self._core.text.bind("<FocusIn>", self._on_focus_in, add="+")
 
         # ── constructor callbacks ─────────────────────────────────────────
         if on_input is not None:
@@ -348,24 +353,35 @@ class TextArea(GridFrame):
 
     def _on_core_change(self, _event: tk.Event) -> None:
         if not self._showing_placeholder:
+            text = self.value
+            if text == self._prev_input_text:
+                return
+            self._prev_input_text = text
             self.event_generate(
                 "<<Input>>",
-                data=InputEvent(text=self.value),
+                data=InputEvent(text=text),
                 when="tail",
             )
 
     def _on_focus_out(self, _event: tk.Event) -> None:
         if self._placeholder_text and not self._core.value:
             self._show_placeholder()
-        if not self._showing_placeholder:
+        if not self._showing_placeholder and self.value != self._prev_changed_value:
             self.event_generate(
                 "<<Changed>>",
-                data=ChangeEvent(value=self.value, text=self.value),
+                data=ChangeEvent(
+                    value=self.value,
+                    text=self.value,
+                    prev_value=self._prev_changed_value),
                 when="tail",
             )
+            self._prev_changed_value = self.value
         if self._rules:
             self._run_validation(trigger="blur")
 
+    def _on_focus_in(self, _event: tk.Event) -> None:
+        self._prev_changed_value = self.value
+
     # ── public value API ──────────────────────────────────────────────────
 
     @property

{bootstack-0.4.2 → bootstack-0.4.4}/src/bootstack/widgets/_impl/primitives/optionmenu.py

@@ -102,9 +102,11 @@ class OptionMenu(MenuButton):
         # Store the textvariable if provided, or create a new one. This variable
         # holds the raw VALUE-KEY text (untranslated): it drives the radio
         # highlight, the public value/selection, and <<Change>> in value-space.
+        _initial_text = self._resolve_initial_text(value)
+        self._prev_value = self._value_by_text.get(_initial_text, _initial_text) if _initial_text else None
         self._textvariable = kwargs.pop('textvariable', None)
         if self._textvariable is None:
-            self._textvariable = StringVar(value=self._resolve_initial_text(value))
+            self._textvariable = StringVar(value=_initial_text)
 
         # A separate variable backs the visible button face, holding the
         # (optionally translated) DISPLAY text — decoupled from the value key so
@@ -208,14 +210,17 @@ class OptionMenu(MenuButton):
 
         def _on_change(text: str) -> None:
             self._sync_display()
+            value = self._value_by_text.get(text, text) if text else None
             self.event_generate(
                 '<<Change>>',
-                data=ChangeEvent(value=self._value_by_text.get(text, text) if text else None),
+                data=ChangeEvent(
+                    value=value,
+                    prev_value=self._prev_value,
+                    text=self._display_text(text)
+                )
             )
+            self._prev_value = value
 
-        # Store it here, not at the call site (#476). A caller that discards the
-        # return leaves an untracked subscription the guard above can never
-        # cancel, and every one of them emits its own <<Change>>.
         self._bind_id = self.textsignal.subscribe(_on_change)
         return self._bind_id
 

{bootstack-0.4.2 → bootstack-0.4.4}/src/bootstack/widgets/codeeditor.py

@@ -140,21 +140,34 @@ class CodeEditor(PublicWidgetBase):
             internal_kwargs["extensions"] = extensions
 
         self._internal = _InternalCodeEditor(tk_master, **internal_kwargs)
+        self._prev_value = self._internal.value
+        self._prev_input_text = self._internal.value
 
         # Generate <<CursorMove>> so on_cursor_move() subscribers always work.
         t = self._internal.core.text
         t.bind("<KeyRelease>",      lambda e: t.event_generate("<<CursorMove>>"), add="+")
         t.bind("<ButtonRelease-1>", lambda e: t.event_generate("<<CursorMove>>"), add="+")
 
-        # Re-emit the core's raw <<Change>> (which carries a low-level
-        # {"op", "index"} dict) as typed payloads on the public widget, so
-        # on_change()/on_input() deliver the editor text — like TextArea.
         def _emit_typed_change(_e: Any = None) -> None:
             text = self._internal.value
-            self._internal.event_generate("<<BsChange>>", data=ChangeEvent(value=text, text=text))
+            if text == self._prev_input_text:
+                return
+            self._prev_input_text = text
             self._internal.event_generate("<<BsInput>>", data=InputEvent(text=text))
         t.bind("<<Change>>", _emit_typed_change, add="+")
 
+        def _emit_typed_blur(_e: Any = None) -> None:
+            text = self._internal.value
+            if text != self._prev_value:
+                self._internal.event_generate("<<BsChange>>",
+                                              data=ChangeEvent(value=text, text=text, prev_value=self._prev_value))
+            self._prev_value = text
+        t.bind("<FocusOut>", _emit_typed_blur, add="+")
+
+        def _on_focus_in(_e: Any = None) -> None:
+            self._prev_value = self._internal.value
+        t.bind("<FocusIn>", _on_focus_in, add="+")
+
         self._attach_to_parent(layout_kw)
 
     # ----- Event routing -----

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

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