bootstack 0.4.7__py3-none-any.whl → 0.4.8__py3-none-any.whl

bootstack/_core/localization.py

@@ -10,7 +10,10 @@ a thin glue layer.
 
 from __future__ import annotations
 
-from typing import Any, TYPE_CHECKING
+import itertools
+import weakref
+from tkinter import TclError
+from typing import Any, Callable, TYPE_CHECKING
 
 from bootstack.i18n.msgcat import MessageCatalog
 from bootstack.i18n.specs import (
@@ -177,6 +180,91 @@ def get_current_locale() -> str:
     return MessageCatalog.locale()
 
 
+# =============================================================================
+# Locale Change Propagation
+# =============================================================================
+
+_LOCALE_EVENT = "<<LocaleChanged>>"
+
+
+# Don't bind a widget's refresh directly on the window: nothing removes it
+# when the widget is destroyed.
+class _LocaleRefreshers:
+    """The refresh methods one toplevel calls on a locale change."""
+
+    def __init__(self, toplevel: Any) -> None:
+        self._toplevel = toplevel
+        self._refreshers: dict[int, weakref.WeakMethod] = {}
+        self._keys = itertools.count()
+        self._funcid: str | None = None
+
+    def add(self, refresh: Callable[[], Any]) -> None:
+        """Register `refresh`, a bound method of a widget on this toplevel."""
+        self._ensure_bound()
+        key = next(self._keys)
+        refreshers = self._refreshers
+        # Drop the entry when the widget is collected, so a window whose
+        # locale never changes does not accumulate dead references either.
+        refreshers[key] = weakref.WeakMethod(
+            refresh, lambda _ref: refreshers.pop(key, None)
+        )
+
+    def _ensure_bound(self) -> None:
+        """Bind the dispatcher, or bind it again if something replaced it.
+
+        A `bind` of the event without `add` on this toplevel replaces every
+        binding for it, the dispatcher included, which would silently stop
+        every widget on the window from refreshing.
+        """
+        toplevel = self._toplevel
+        if self._funcid is not None:
+            script = str(toplevel.tk.call("bind", toplevel._w, _LOCALE_EVENT))
+            # The line prefix `_patched_bind` emits, as `_patched_unbind` matches it.
+            if ('if {"[%s ' % self._funcid) in script:
+                return
+        self._funcid = toplevel.bind(_LOCALE_EVENT, self._dispatch, add="+")
+
+    def _dispatch(self, _event: Any = None) -> None:
+        """Call each live widget's refresh, in the order they registered."""
+        for key, ref in list(self._refreshers.items()):
+            refresh = ref()
+            if refresh is None:
+                continue
+            widget = refresh.__self__
+            try:
+                alive = widget.winfo_exists()
+            except TclError:
+                alive = False
+            if not alive:
+                # Destroyed, but still referenced from somewhere else.
+                self._refreshers.pop(key, None)
+                continue
+            try:
+                refresh()
+            except Exception:
+                # Report and carry on, as a handler bound on its own would:
+                # one failing widget must not stop the rest from refreshing.
+                widget._report_exception()
+
+
+def bind_locale_refresh(refresh: Callable[[], Any]) -> None:
+    """Call `refresh` on every locale change for as long as its widget exists.
+
+    The locale-change event is generated on the root; `refresh` is called,
+    with no arguments, when the event reaches the toplevel of the widget it is
+    bound to, after the widgets registered before it. A destroyed widget is
+    never called, and registering holds no strong reference to it.
+
+    Args:
+        refresh: A bound method of the widget to refresh.
+    """
+    toplevel = refresh.__self__.winfo_toplevel()
+    refreshers = toplevel.__dict__.get("_bs_locale_refreshers")
+    if refreshers is None:
+        refreshers = toplevel._bs_locale_refreshers = _LocaleRefreshers(toplevel)
+    refreshers.add(refresh)
+
+
 # =============================================================================
 # Signal Formatting
 # =============================================================================
@@ -227,5 +315,6 @@ __all__ = [
     "resolve_variable_text",
     "apply_spec",
     "get_current_locale",
+    "bind_locale_refresh",
     "create_formatted_signal",
 ]

bootstack/style/style_builder_ttk.py

@@ -9,6 +9,7 @@ from bootstack._core.exceptions import StyleBuilderError
 from bootstack.style.style_builder_base import StyleBuilderBase
 from bootstack.style.element import Element, ElementImage
 from bootstack.style.theme_provider import ThemeProvider
+from bootstack.style.utility import pretile_element_image
 
 
 class BuilderCallable(Protocol):
@@ -344,8 +345,37 @@ class StyleBuilderTtk(StyleBuilderBase):
         if name in existing:
             # Element already exists; avoid duplicate creation error on theme rebuilds
             return
+        try:
+            args, kwargs = self._pretile_element_images(args, kwargs)
+        except Exception:
+            # Pre-tiling only speeds painting up; the element draws from its own images.
+            from bootstack._runtime.utility import debug_log_exception
+            debug_log_exception(f"could not pre-tile the images of element {name!r}")
         self.style.element_create(name, "image", *args, **kwargs)
 
+    def _pretile_element_images(self, args: list, kwargs: dict) -> tuple[list, dict]:
+        """Swap an element's images for copies that paint a wide parcel in few repeats.
+
+        Only an element that stretches horizontally is pre-tiled; one that does
+        not is drawn at its image's own width, so a wider image would draw wider.
+        No `sticky` means `nsew`.
+        """
+        sticky = kwargs.get("sticky")
+        if sticky is not None and not ("e" in sticky and "w" in sticky):
+            return args, kwargs
+
+        master = self.style.master
+        border = kwargs.get("border", 0)
+        default, *specs = args
+        tiled = [pretile_element_image(default, border, master)]
+        tiled += [(state, pretile_element_image(image, border, master)) for state, image in specs]
+
+        if tiled[0] != default and "width" not in kwargs:
+            # The element's minimum width defaults to its image's width, so pin
+            # it to the original image's.
+            kwargs = {**kwargs, "width": int(self.style.tk.call("image", "width", default))}
+        return tiled, kwargs
+
     def create_style_layout(self, ttk_style: str, element: Element | list[Element]):
         if isinstance(element, list):
             self.style.layout(ttk_style, [e.spec() for e in element])

bootstack/style/utility.py

@@ -1,3 +1,4 @@
+import tkinter
 from colorsys import hls_to_rgb, rgb_to_hls
 from dataclasses import dataclass
 from pathlib import Path
@@ -553,6 +554,73 @@ def recolor_element_image(
     return ElementImageResult(image=photo_image, meta=meta)
 
 
+PRETILE_SPAN = 256
+"""The width, in pixels, an element image's middle column is repeated to."""
+
+
+def pretile_element_image(
+    image: str,
+    border: int | tuple[int, ...] | list[int],
+    master: tkinter.Misc,
+) -> str:
+    """Return a copy of an element image with its middle column repeated.
+
+    A stretched image element is drawn by repeating its middle column across the
+    parcel, one draw per repeat, so an element image only a few pixels wide makes
+    a wide widget slow to paint. The copy repeats the column to at least
+    `PRETILE_SPAN` pixels, in whole repeats starting at the column's left edge as
+    the element's own drawing does, so it draws the same pixels in fewer repeats.
+    The left and right columns are copied unchanged.
+
+    Copies are cached by source image and border, so elements that share an image
+    share its copy.
+
+    Args:
+        image: Name of the source photo image.
+        border: The element's border: one value, or up to four in the order left,
+            top, right, bottom, where right defaults to left.
+        master: Widget whose interpreter owns `image`.
+
+    Returns:
+        The name of the copy, or `image` itself when its middle column is already
+        at least `PRETILE_SPAN` pixels wide or has no width.
+    """
+    values = [border] if isinstance(border, int) else list(border)
+    left = int(values[0]) if values else 0
+    right = int(values[2]) if len(values) > 2 else left
+
+    cache_key = ("element-pretile", str(image), left, right)
+    cached = ImageService.get_cached(cache_key)
+    if cached is not None:
+        return str(cached)
+
+    tk = master.tk
+    width = int(tk.call("image", "width", image))
+    height = int(tk.call("image", "height", image))
+    middle = width - left - right
+    if middle <= 0 or middle >= PRETILE_SPAN:
+        return str(image)
+
+    span = middle * -(-PRETILE_SPAN // middle)
+    tiled = tkinter.PhotoImage(master=master, width=left + span + right, height=height)
+
+    def copy(x0: int, x1: int, *to: int) -> None:
+        tk.call(
+            tiled, "copy", image, "-from", x0, 0, x1, height,
+            "-to", *to, "-compositingrule", "set",
+        )
+
+    if left:
+        copy(0, left, 0, 0)
+    # A -to rectangle larger than the -from region repeats the region across it.
+    copy(left, left + middle, left, 0, left + span, height)
+    if right:
+        copy(width - right, width, left + span, 0)
+
+    ImageService.set_cached(cache_key, tiled)
+    return str(tiled)
+
+
 def should_darken(bg_hex: str) -> bool:
     """Determine whether to darken or lighten based on luminance and saturation."""
     r, g, b = [v / 255.0 for v in ImageColor.getrgb(bg_hex)]

bootstack/widgets/_core/base.py

@@ -446,8 +446,14 @@ class PublicWidgetBase:
         if placement.method == "flex":
             # The FlexFrame's managed list IS the attached-sibling order, so the
             # current managed index is the slot a plain attach() should restore.
+            from bootstack.widgets._core.container import snapshot_flex_slot
+
             idx = placement.master.index_of(self._internal)
-            placement.index = idx if idx >= 0 else None
+            if idx >= 0:
+                snapshot_flex_slot(placement, placement.master, idx)
+            else:
+                placement.index = None
+                placement.preceding = ()
             placement.master.remove_child(self._internal)
         elif placement.method == "pack":
             slaves = list(placement.master.pack_slaves())
@@ -485,7 +491,7 @@ class PublicWidgetBase:
         """
         from bootstack.widgets._core.container import (
             PACK_KEYS, GRID_KEYS, PLACE_KEYS, normalize_fill, _expand_margin, _flex_child_opts,
-            _reject_legacy_child_kwargs, resolve_pack_order
+            _reject_legacy_child_kwargs, resolve_pack_order, restored_flex_index
         )
 
         placement = getattr(self, "_placement", None)
@@ -503,7 +509,10 @@ class PublicWidgetBase:
         options = dict(placement.options)
 
         if placement.method == "flex":
-            index = kwargs.pop("index", placement.index)
+            if "index" in kwargs:
+                index = kwargs.pop("index")
+            else:
+                index = restored_flex_index(placement)
             if kwargs:
                 _reject_legacy_child_kwargs(kwargs, type(self).__name__, "flex child")
                 _expand_margin(kwargs)

bootstack/widgets/_core/container.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import tkinter
+import weakref
 from typing import Any, Literal
 
 PACK_KEYS = frozenset({
@@ -101,11 +102,12 @@ class Placement:
     Recorded on the child at layout time by `guide_layout`; consumed by
     `PublicWidgetBase.detach`/`attach` to remove and re-insert the widget
     without re-running its constructor. `options` holds the resolved Tk
-    geometry-manager options (no ordering refs); `index` is the pack position
-    among siblings, snapshotted afresh on each `detach`.
+    geometry-manager options (no ordering refs); `index` is the position among
+    siblings, snapshotted afresh on each `detach`. For a flex child, set it
+    with `snapshot_flex_slot`, which keeps `preceding` in step with it.
     """
 
-    __slots__ = ("method", "master", "options", "index")
+    __slots__ = ("method", "master", "options", "index", "preceding")
 
     def __init__(
         self,
@@ -114,10 +116,31 @@ class Placement:
         options: dict,
         index: int | None = None,
     ) -> None:
-        self.method = method      # "pack" | "grid" | "place"
+        self.method = method      # "pack" | "grid" | "place" | "flex"
         self.master = master      # the Tk master the child is placed in
         self.options = options    # resolved Tk options (no before/after/index)
         self.index = index        # pack order among siblings (snapshot at detach)
+        self.preceding: tuple = ()  # weakrefs to the flex siblings before `index`
+
+
+def snapshot_flex_slot(placement: Placement, frame: Any, index: int) -> None:
+    """Record `index` in `frame` as the slot a plain `attach()` restores.
+
+    The siblings before the slot are kept by weak reference so that one
+    destroyed before the attach no longer counts toward the index.
+    """
+    placement.index = index
+    placement.preceding = tuple(weakref.ref(w) for w, _ in frame._managed[:index])
+
+
+def restored_flex_index(placement: Placement) -> int | None:
+    """The snapshotted slot, less the preceding siblings destroyed since."""
+    from bootstack.widgets._impl.primitives.flexframe import _alive
+
+    if placement.index is None:
+        return None
+    gone = sum(1 for ref in placement.preceding if not ((w := ref()) and _alive(w)))
+    return max(placement.index - gone, 0)
 
 
 def resolve_pack_order(order: dict, master: tkinter.Misc) -> dict:
@@ -441,8 +464,11 @@ def place_flex_child(
         frame.add_child(child._internal, opts, index=index)
         child._placement = Placement("flex", frame, opts)
     else:
-        # Record the slot a later attach() restores: an explicit index, else the
-        # natural append position (current child count).
-        if index is None:
-            index = len(frame._managed)
+        # Record the slot a later attach() restores: an explicit index as given,
+        # else the natural append position (current child count).
         child._placement = Placement("flex", frame, opts, index=index)
+        if index is None:
+            # Prune first: a dead sibling left in `_managed` would be counted
+            # twice, once in the count and again when attach() discounts it.
+            frame._prune_destroyed()
+            snapshot_flex_slot(child._placement, frame, len(frame._managed))

bootstack/widgets/_impl/_parts/spinnerentry_part.py

@@ -8,6 +8,7 @@ both text and numeric values.
 from tkinter import Event, TclError
 from typing import Any, Callable
 
+from bootstack._core.localization import bind_locale_refresh
 from bootstack.events import ChangeEvent, InputEvent
 from bootstack.i18n import MessageCatalog, IntlFormatter
 from bootstack.widgets._impl.primitives.spinbox import Spinbox
@@ -131,7 +132,7 @@ class SpinnerEntryPart(ValidationMixin, Spinbox):
         self.bind('<FocusIn>', self._store_prev_value, add=True)
         self.bind('<FocusOut>', self._handle_focus_out, add=True)
         self.bind('<Return>', self._handle_return, add=True)
-        self.winfo_toplevel().bind('<<LocaleChanged>>', self._on_locale_changed, add='+')
+        bind_locale_refresh(self._on_locale_changed)
 
         # Set initial focus
         if initial_focus:

bootstack/widgets/_impl/_parts/textentry_part.py

@@ -1,6 +1,7 @@
 from tkinter import Event, TclError
 from typing import Any, Callable
 
+from bootstack._core.localization import bind_locale_refresh
 from bootstack.events import ChangeEvent, InputEvent
 from bootstack.i18n import MessageCatalog, IntlFormatter
 from bootstack.widgets._impl.primitives.entry import Entry
@@ -102,7 +103,7 @@ class TextEntryPart(ValidationMixin, Entry):
         self.bind('<FocusIn>', self._store_prev_value, add=True)
         self.bind('<FocusOut>', self._handle_focus_out, add=True)
         self.bind('<Return>', self._handle_return, add=True)
-        self.winfo_toplevel().bind('<<LocaleChanged>>', self._on_locale_changed, add='+')
+        bind_locale_refresh(self._on_locale_changed)
 
         # set initial focus
         if initial_focus:

bootstack/widgets/_impl/composites/selectbox.py

@@ -4,6 +4,7 @@ from typing_extensions import Unpack
 
 from typing import Any
 
+from bootstack._core.localization import bind_locale_refresh
 from bootstack.events import ChangeEvent
 from bootstack.widgets._core.options import (
     cluster_records,
@@ -139,7 +140,7 @@ class SelectBox(Field):
         self._entry._get_validation_value = self._validation_value
 
         # Re-translate the displayed text + option maps on a live locale switch.
-        self.winfo_toplevel().bind('<<LocaleChanged>>', self._on_locale_changed_refresh, add='+')
+        bind_locale_refresh(self._on_locale_changed_refresh)
 
         self._group_by = group_by
         self._max_visible_items = max_visible_items

bootstack/widgets/_impl/composites/tabs/tabview.py

@@ -17,6 +17,7 @@ from bootstack.events import (
 from bootstack.widgets._impl.composites.pagestack import PageStack
 from bootstack.widgets.types import Master
 from bootstack._core import NavigationError
+from bootstack._core.localization import bind_locale_refresh
 
 
 class TabView(Frame):
@@ -121,9 +122,7 @@ class TabView(Frame):
         self._trace_id = self._tab_variable.trace_add('write', self._on_tab_selected)
 
         # Locale retranslation
-        self.winfo_toplevel().bind(
-            "<<LocaleChanged>>", self._on_locale_changed, add='+'
-        )
+        bind_locale_refresh(self._on_locale_changed)
 
         # Clean up trace on destroy
         self.bind('<Destroy>', self._on_destroy, add='+')

bootstack/widgets/_impl/mixins/localization_mixin.py

@@ -18,6 +18,7 @@ from bootstack._core.localization import (
     resolve_text,
     resolve_variable_text,
     apply_spec,
+    bind_locale_refresh,
     create_formatted_signal,
 )
 from bootstack.i18n.specs import (
@@ -67,8 +68,7 @@ class LocalizationMixin(Misc):
         self._localize_mode = localize
         self._default_value_format = value_format
 
-        root = self.winfo_toplevel()  # event is generated on root
-        root.bind("<<LocaleChanged>>", self._on_locale_changed, add="+")
+        bind_locale_refresh(self._on_locale_changed)
 
         # Check if widget has a textsignal or textvariable with value_format
         if value_format and self._has_signal_or_variable():

bootstack/widgets/_impl/primitives/flexframe.py

@@ -107,7 +107,8 @@ class FlexFrame(Frame):
         self._gap = gap
         # Ordered (widget, opts) entries. opts may carry: grow, horizontal,
         # vertical, padx, pady (resolved margins), and spacer metadata
-        # (_spacer, _spacer_size, _spacer_weight).
+        # (_spacer, _spacer_size, _spacer_weight). add_child adds the id of the
+        # child's <Destroy> binding (_destroy_bind).
         self._managed: list[tuple[tk.Widget, dict[str, Any]]] = []
         # Highest main-axis track index configured on the previous relayout,
         # so we can zero stale tracks when the plan shrinks.
@@ -116,6 +117,12 @@ class FlexFrame(Frame):
         # append fast-path decide in O(1) whether the stack is "pure" (see
         # `_can_append_in_place`) without rescanning every add.
         self._flex_child_count = 0
+        # Set when a managed child is destroyed out-of-band (Tk destroy()
+        # bypasses remove_child). Until it is dropped, the dead child keeps its
+        # track, so the next fast-path append would land after it with a
+        # leading gap. `_prune_destroyed` re-plans once, before the next add or
+        # index lookup, or at idle if neither comes.
+        self._needs_prune = False
         if propagate is not None:
             self.grid_propagate(propagate)
 
@@ -197,6 +204,7 @@ class FlexFrame(Frame):
 
     def index_of(self, widget: tk.Widget) -> int:
         """Return the managed index of `widget`, or -1 if not managed."""
+        self._prune_destroyed()
         for i, (w, _) in enumerate(self._managed):
             if w is widget:
                 return i
@@ -215,7 +223,18 @@ class FlexFrame(Frame):
         sibling's track — a mid-list insert, a distribution mode, or a
         grow/spacer child — takes the full `_relayout`.
         """
-        entry = (widget, dict(opts))
+        # Close up behind any child destroyed since the last change, so `index`
+        # counts live siblings and the fast path's next track follows them.
+        self._prune_destroyed()
+        opts = dict(opts)
+        # Kept in opts so remove_child can drop it and a detach/attach cycle
+        # does not stack up handlers.
+        opts["_destroy_bind"] = widget.bind(
+            "<Destroy>",
+            lambda e, w=widget: self._on_child_destroy(e, w),
+            add="+",
+        )
+        entry = (widget, opts)
         appending = index is None or index >= len(self._managed)
         new_is_flex = bool(opts.get("grow")) or bool(opts.get("_spacer"))
         # Decide the fast path BEFORE the count reflects this child (the check
@@ -240,6 +259,7 @@ class FlexFrame(Frame):
         _, removed_opts = self._managed[idx]
         if removed_opts.get("grow") or removed_opts.get("_spacer"):
             self._flex_child_count -= 1
+        widget.unbind("<Destroy>", removed_opts["_destroy_bind"])
         try:
             tk.Grid.forget(widget)
         except tk.TclError:
@@ -247,6 +267,27 @@ class FlexFrame(Frame):
         self._managed.pop(idx)
         self._relayout()
 
+    def _on_child_destroy(self, event: tk.Event, widget: tk.Widget) -> None:
+        """Flag a prune when a managed child is destroyed, and schedule one."""
+        if event.widget is not widget or self._needs_prune:
+            return
+        self._needs_prune = True
+        # On the root: an idle job owned by this frame would be orphaned when
+        # the frame itself is destroyed along with its children.
+        try:
+            self._root().after_idle(self._prune_destroyed)
+        except (tk.TclError, AttributeError):
+            pass
+
+    def _prune_destroyed(self) -> None:
+        """Drop children destroyed out-of-band and close up the survivors.
+
+        `_relayout` does the dropping and re-grids survivors in place, so they
+        see no `<Unmap>`/`<Map>`. A no-op unless a destroy was flagged.
+        """
+        if self._needs_prune and _alive(self):
+            self._relayout()
+
     def _can_append_in_place(self) -> bool:
         """True when appending a plain child cannot move any existing sibling.
 
@@ -385,6 +426,7 @@ class FlexFrame(Frame):
         # Drop children destroyed out from under us: Tk's destroy() does not route
         # through remove_child, so a dead child lingers in _managed and re-gridding
         # it below would raise "bad window path name". (GridFrame guards the same.)
+        self._needs_prune = False
         if any(not _alive(w) for w, _ in self._managed):
             self._managed = [e for e in self._managed if _alive(e[0])]
             self._flex_child_count = sum(
@@ -492,9 +534,9 @@ class FlexFrame(Frame):
                 trail = margin_main[1]
             elif margin_main is not None:
                 lead += margin_main
-            pad: dict[str, Any] = {}
-            if lead or trail:
-                pad[main_axis] = (lead, trail)
+            # Always written: re-gridding in place keeps any option not passed,
+            # so a survivor that becomes the first child would keep its gap.
+            pad: dict[str, Any] = {main_axis: (lead, trail)}
             margin_cross = o.get(cross_axis)
             if margin_cross is not None:
                 pad[cross_axis] = margin_cross

bootstack/widgets/_impl/primitives/optionmenu.py

@@ -5,6 +5,7 @@ from typing import Any, Callable, TypedDict, TYPE_CHECKING
 
 from typing_extensions import Unpack
 
+from bootstack._core.localization import bind_locale_refresh
 from bootstack.events import ChangeEvent
 from bootstack.widgets._core.options import normalize_options, option_display, record_to_dict
 from bootstack.widgets._impl.composites.contextmenu import ContextMenu, ContextMenuItem
@@ -125,9 +126,8 @@ class OptionMenu(MenuButton):
         # Bind signal to change event (also keeps the face display in sync)
         self._bind_change_event()
         self._sync_display()
-        # The locale-change event is generated on the root; bind there (not on
-        # self) so the face re-translates live, matching the mixin's pattern.
-        self.winfo_toplevel().bind('<<LocaleChanged>>', lambda _e: self._sync_display(), add="+")
+        # Re-translate the face live on a locale change, as the mixin does.
+        bind_locale_refresh(self._sync_display)
 
         # Create menu items that update the shared variable
         self._context_menu = self._build_context_menu()

bootstack/widgets/label.py

@@ -108,24 +108,20 @@ class Label(IconProperty, ImageProperty, PublicWidgetBase):
 
             if isinstance(image, _ImageHandle):
                 deferred_image = image
-                has_text = bool(text) or textsignal is not None
-                if not has_text or icon_only:
-                    internal_kwargs["icon_only"] = True
-                    internal_kwargs["compound"] = "image"
-                else:
-                    internal_kwargs["compound"] = icon_position
             else:
                 internal_kwargs["image"] = image
         if icon is not None:
             internal_kwargs["icon"] = icon
-            has_text = bool(text) or textsignal is not None
-            if not has_text or icon_only:
-                internal_kwargs["icon_only"] = True
-                internal_kwargs["compound"] = "image"
-            else:
-                internal_kwargs["compound"] = icon_position
-        elif icon_only:
+        has_text = bool(text) or textsignal is not None
+        has_graphic = icon is not None or image is not None
+        if icon_only or (has_graphic and not has_text):
             internal_kwargs["icon_only"] = True
+            if has_graphic:
+                internal_kwargs["compound"] = "image"
+        elif has_text:
+            # Set even without a graphic, so an icon or image assigned later
+            # sits beside the text instead of replacing it.
+            internal_kwargs["compound"] = icon_position
         if anchor is not None:
             internal_kwargs["anchor"] = anchor
         if justify is not None:

{bootstack-0.4.7.dist-info → bootstack-0.4.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.4.7
+Version: 0.4.8
 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.7.dist-info → bootstack-0.4.8.dist-info}/RECORD

@@ -12,7 +12,7 @@ bootstack/_core/__init__.py,sha256=Ib1dWGMP7RvvZ95h9qGCKP0RTseX2Ki6gFf_roKpprw,3
 bootstack/_core/capture.py,sha256=wOH2DilCRh1oHIb_ymK-2X9EYUb2k_H7sjoLuyXSftA,19366
 bootstack/_core/exceptions.py,sha256=9HazDsy88JjdoT6YTg5yVVk9b1aofp8gG_N4uFDPo9U,656
 bootstack/_core/images.py,sha256=Gn5WnBRzq_qmhc8LjnTrD7BSXz-l22gDwzuAAZsExGo,18206
-bootstack/_core/localization.py,sha256=BOsNkH_1BAqKrRkbhOiQNuNfzyICYsoF6-MsXx__vWQ,7256
+bootstack/_core/localization.py,sha256=4AXhYCslqQPGThGyeGcYNcUnpD3Ah_4QjBoSOwSUxHM,10950
 bootstack/_core/paths.py,sha256=rBhbFg4Z6__8K_y1Z15b5Xe_alOHvAlCtTbip2Qih-E,1714
 bootstack/_core/signal_binding.py,sha256=j3MuiuvUL7YrKTczwo96xy2KQRk5zXFgr29lwd41GPo,7480
 bootstack/_core/variables.py,sha256=OHvDBEBnuSGYwtYsjaYGVBirfkZ9DkPChkKEOZQQuwo,2020
@@ -200,7 +200,7 @@ bootstack/style/style.py,sha256=3UzQaFFa97Oj7D_qiBeIvifd7UDhkjSQ_-n3k0CBlAs,2156
 bootstack/style/style_builder_base.py,sha256=O5UhaoKUCdufw9WL5EWj-N4QSUFI0jxb3VceQpEc54w,30185
 bootstack/style/style_builder_mixed.py,sha256=SRzXYkq2etFrk3wS5hsAbjDRWm2VtUPHSk6s9ki3JLc,3737
 bootstack/style/style_builder_tk.py,sha256=dFXoAIcSsvSOWNhQ8YWag2vpjUZKo-0NIG6mdveBC5E,3798
-bootstack/style/style_builder_ttk.py,sha256=gyM7HarQ5L9TxkjKRD3P0eHndpC8sEJfJeBhY9O2TLs,13106
+bootstack/style/style_builder_ttk.py,sha256=MewVKYP-QDZ8RsUiOrMdqNHyOMTIg44pJpued1nBu-s,14651
 bootstack/style/style_resolver.py,sha256=rkyKZvKbh0qDBIDfyS-Puwl_H2a5YuQlGWXhbgtk98w,16519
 bootstack/style/theme.py,sha256=Oa8pBuOLUvHPKa5eCQdhXPPJli_AplR_WwP-C7Cl80g,10402
 bootstack/style/theme_provider.py,sha256=dGlzEVdlGHPwGTvCa9evGYqSo9donsL6qvaC1kbsKQ4,17452
@@ -208,7 +208,7 @@ bootstack/style/tk_patch.py,sha256=0rRJEUQYqt3YVakl-c-Irfp8uC35GTHX0pq-655lFAc,1
 bootstack/style/token_maps.py,sha256=xlaCJHqPT-3B1wWmpweRYl2TMjTGLinBLoJQPMp-xVQ,1290
 bootstack/style/types.py,sha256=_Tnxs_TI_FyR_pMnHqMKR5BE-OwE8mlPJ0VjgRgA6Mg,1196
 bootstack/style/typography.py,sha256=pTAQlKcOyqMpmjFngf8tCYq85pbV7zPv8mHw5raE_9I,17026
-bootstack/style/utility.py,sha256=OM8Du3yvAErIMPSOikTirbZPLbyo1x0U3RreVD689K4,25576
+bootstack/style/utility.py,sha256=UpzRSgwfHU5frv8Q2ULvAWwNvhStn5_27sLrpOEoX-8,28140
 bootstack/style/builders/__init__.py,sha256=UiLt9WJWnFHAa8zR2sWydeW2756flMQZarw2tDTlnOg,1272
 bootstack/style/builders/badge.py,sha256=3OQiA4n93c74Df64sfsuC-v3nM8rJ_KnwBx-OOE_r38,2018
 bootstack/style/builders/button.py,sha256=u-96U4nwFvALNKWwRTYmX9mWUb0u76SgAyKwwL2OMuk,11822
@@ -271,7 +271,7 @@ bootstack/widgets/gallery.py,sha256=JAboTI4kB9PeVdONhY9-HHM4_e1VnvHiKjolKGIUFhA,
 bootstack/widgets/gauge.py,sha256=1ediRKxTSzid3doyzOX3ZN9xzjz4oq7nhyInKoqaZpI,6682
 bootstack/widgets/grid.py,sha256=JiOdgL4YmCYI1MBs6UWN01EtTeVBFmTv7r-jHYX9Ld0,5418
 bootstack/widgets/groupbox.py,sha256=2Gbx7hVezkrNkcEuTy_Nuj5w-O9hnuyeKyaHhzF_m1g,6928
-bootstack/widgets/label.py,sha256=RnAz-jxCM3ib3QJrgafyPwvPzGGOsSFhlp8C2N9Fx54,9774
+bootstack/widgets/label.py,sha256=MEQNG9wURtiEB32rQZCEwMh4v3JmtJFlKl0FyJfHBLU,9620
 bootstack/widgets/listview.py,sha256=xZkEYIMtbDSsJCs46MFdFtObDSnPos7mQJIc1gPFeL8,14788
 bootstack/widgets/menubutton.py,sha256=wbWBFE82fJ7b1HeBA1rm-wjhXPw3Q69XArPZlAqyOJw,16545
 bootstack/widgets/numberfield.py,sha256=FtoadKMP4b4yVbKJclyicSeP3JeoE77axtrtj94ISaw,16313
@@ -309,9 +309,9 @@ bootstack/widgets/types.py,sha256=_86PwJ20gim0hGnCdPYSn1YVrrsTfZhyQ1zWDwHqQTY,13
 bootstack/widgets/window.py,sha256=lwzYO6uAeXM_lSMXES911OsX8aVrJPKQHJu1u30bAIo,12921
 bootstack/widgets/_core/__init__.py,sha256=rJPvvI3eOV9M5cICBD2XPZFokThf_tQyTeZhLPaqukU,1106
 bootstack/widgets/_core/app_config.py,sha256=h_OaJ0jSif1eJeHWErpsXNyhtfCcmYQCcq0VriM48uk,9771
-bootstack/widgets/_core/base.py,sha256=ca6UltQDDjdeOwr6iu1tuUdsh5oqcXFuJxEQzRZaxA4,27605
+bootstack/widgets/_core/base.py,sha256=u8ZamP8uahu3w8iwSxMnycvUdRkALR8J_ozvLDLazHo,27943
 bootstack/widgets/_core/choices.py,sha256=IGm4NspPJQgnGOxfuXWsqs4nSk7HSkdH0P60Cd1gnjo,2369
-bootstack/widgets/_core/container.py,sha256=h40FyWl_kY6WCioMKUMc9FYjI7t0dCq4u-VlvKdHrXA,18893
+bootstack/widgets/_core/container.py,sha256=bpwWOTtyzzDUQ354ZBtw2NT-XfESKKrCDQo3iRaVRx4,20170
 bootstack/widgets/_core/context.py,sha256=laL75HYr7kIx3KbZqtT_rO1wWRjV4pehNzWgcZUkw_I,764
 bootstack/widgets/_core/events.py,sha256=-Hlg3KiITXoei4QxlAmjw65jVXSnr3s81s9PWcdaaKo,3791
 bootstack/widgets/_core/field_mixin.py,sha256=kFHOcSs16x20PEDuakVmukkzEMqA1cKfqtGZicxD-zU,16557
@@ -328,8 +328,8 @@ bootstack/widgets/_impl/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeR
 bootstack/widgets/_impl/_internal/wrapper_base.py,sha256=ztjz9tbC5w1HLlgOC5galPhk2mZfmWJk7Mcq9D4YC58,12731
 bootstack/widgets/_impl/_parts/__init__.py,sha256=DdRqDmFQevi7KLWhuyffsfvSSCEBACi6tZJYPPAptoA,371
 bootstack/widgets/_impl/_parts/numberentry_part.py,sha256=wCHfO0ZB9n2vSXpiJ0c4k0Cf5pn9FdzGZzVcaKdU49M,15463
-bootstack/widgets/_impl/_parts/spinnerentry_part.py,sha256=X5Lkqy62cjyKj12IdjhL_OYjBbYOVn-PDahOlqWIzxA,17353
-bootstack/widgets/_impl/_parts/textentry_part.py,sha256=A7n-YXMJNc-UIQL3q_T_gIIRFPXx3l6qBPxwOSlT3K0,17152
+bootstack/widgets/_impl/_parts/spinnerentry_part.py,sha256=e73MGW-wTzjf0e4ZChZSN8O3498Zycm-0oRgEykd_Ls,17378
+bootstack/widgets/_impl/_parts/textentry_part.py,sha256=wDEVaY4jhWW2iyyZ-s2N4KxV51OsUgYGWgiLXLocVYE,17177
 bootstack/widgets/_impl/composites/__init__.py,sha256=uNb9c9-i-vfq9vhZgwRxsBw0KL2BYNdZOWy7pb_QZDk,1077
 bootstack/widgets/_impl/composites/_dateutils.py,sha256=DQhiy_PsR6MAJT8zYBwwJTpsgrkQ2C9SDzm2Z5qLcyc,1075
 bootstack/widgets/_impl/composites/_image_fit.py,sha256=MwEfaXibW1htqUu5fvinenuN7LWiEX7Ydz3a-IxJjAk,3638
@@ -357,7 +357,7 @@ bootstack/widgets/_impl/composites/radiogroup.py,sha256=CEYhCfBgH19Y7x-63nqKdycb
 bootstack/widgets/_impl/composites/scrolledtext.py,sha256=Dkp2ATIe-UADhvVDl6W6xEEwe-3AWkv2mESC5wP9Xik,15000
 bootstack/widgets/_impl/composites/scrolledtext.pyi,sha256=GceUarQJWlYKA2nly7mbIA3LJDxOJXO0QQyKEbbiQ3U,6475
 bootstack/widgets/_impl/composites/scrollview.py,sha256=zGN-xG0lIgB2O5Yz7j-LF4UeGR6-Fx-KjoplqMzZp78,32762
-bootstack/widgets/_impl/composites/selectbox.py,sha256=3oXYUYhjlaP4zUaY_D1pvyez3VZEvX42oceK7FEX8Iw,58642
+bootstack/widgets/_impl/composites/selectbox.py,sha256=YozC4_yjxdGzqogPixNFtOigg_Vhl5YkzjsJYzvUAyQ,58667
 bootstack/widgets/_impl/composites/spinnerentry.py,sha256=6CSvsastkc9j6CsloFsaDACSDrfrkoFda9BlYEjJwzQ,7006
 bootstack/widgets/_impl/composites/textentry.py,sha256=xH5NqG5bbMlv-OgaifIYkgUcNvXVSi4Q3VhFwqvCV50,2978
 bootstack/widgets/_impl/composites/timeentry.py,sha256=T5X93ueTDvUEemD5y96jt6_ApQHeMjWON6p-YW1T9lY,7503
@@ -394,7 +394,7 @@ bootstack/widgets/_impl/composites/tableview/types.py,sha256=oDmJco19M42Zv_lUEps
 bootstack/widgets/_impl/composites/tabs/__init__.py,sha256=yRRJCO9egzFCDNN7xDyQcH8KqCQx6AgGE-eVtpn4KSc,427
 bootstack/widgets/_impl/composites/tabs/tabitem.py,sha256=MOdJuIOEHp80WSBO2Jg8Nh45OXzxdmUDc1FnYiYR-SQ,15160
 bootstack/widgets/_impl/composites/tabs/tabs.py,sha256=1SL8YCkVPSkIfOobummodbY4zR07s9ZSsj3m0vLz22I,38264
-bootstack/widgets/_impl/composites/tabs/tabview.py,sha256=uzQYe1ImZP9GKY-3XfxoqZx9oZVbmTz7d9hkJIo-a5A,22917
+bootstack/widgets/_impl/composites/tabs/tabview.py,sha256=SzuvOXAkzkkIrs7rCP63QKA5W4oaJZoGV1x8zJMWjns,22918
 bootstack/widgets/_impl/composites/textarea/__init__.py,sha256=tqNmDfbAsnwIRtz6kfstkfH3jD_mZd5I5SUMLmsWU74,721
 bootstack/widgets/_impl/composites/textarea/change.py,sha256=VO4mmBkCjukm5Qmddl-7C6teRf0fri24L5w31vVCXl4,1556
 bootstack/widgets/_impl/composites/textarea/codeeditor.py,sha256=SPLw3OoPxfhoKTrxM-RfVe1UFIxZiGI1dLhJofHmb5s,21711
@@ -424,7 +424,7 @@ bootstack/widgets/_impl/mixins/configure_mixin.py,sha256=iHSE-kUVE4r1ew-AbRd4Xqy
 bootstack/widgets/_impl/mixins/entry_mixin.py,sha256=hBp2h34KDWqYr_H2P1-63_JwVARoDvvL04hX6nD_0Ho,4405
 bootstack/widgets/_impl/mixins/font_mixin.py,sha256=XyoPC10ByhM5IoTTztyzwRxNut0_BwewRTaBPZYSGjg,12295
 bootstack/widgets/_impl/mixins/icon_mixin.py,sha256=ScSQuSwGf8uo5ykXxdXTeNteRm2xIgUxiDd_LxIeQUs,1993
-bootstack/widgets/_impl/mixins/localization_mixin.py,sha256=ZceeudYQumJobVc8ixy9WefzCeRLLYxVgrzql_U1yjI,9800
+bootstack/widgets/_impl/mixins/localization_mixin.py,sha256=md7L1sfgNRNitQyOgpyNRml-nSaVC1fBfdDZvZyKvn0,9738
 bootstack/widgets/_impl/mixins/signal_mixin.py,sha256=k1fnEe__S6N81W8xh-WEwyWJeFjWrJKDNyFIZnJheRw,9853
 bootstack/widgets/_impl/mixins/validation_mixin.py,sha256=nJSDbYeMHoEsJuVPzg5L3rB_GHLnp0CtBEvvb89ayNc,8847
 bootstack/widgets/_impl/primitives/__init__.py,sha256=TK1pfKns8H1a5nVCBvGGwXkkv9qeXSYGG8cESO5Etw4,1143
@@ -436,12 +436,12 @@ bootstack/widgets/_impl/primitives/checkbutton.py,sha256=avIG6zhW-TATa9cYFrw-tF-
 bootstack/widgets/_impl/primitives/checktoggle.py,sha256=x_A6sFIeUJwc8MHz_1uBAMCQV0YQFUZx6LKXM0qdnvE,3565
 bootstack/widgets/_impl/primitives/combobox.py,sha256=GPBzFgYYq0RW8FBwtaPpYzc7CeUSuGGyMEIx_EGtQsg,6297
 bootstack/widgets/_impl/primitives/entry.py,sha256=surq9Slix7hRPXjblN-EhVaMsKCJnQyxFeCoPwVvu14,3499
-bootstack/widgets/_impl/primitives/flexframe.py,sha256=Kpj0E0cybMGDLNdClJ_56khkNedA7sj4EwvYlFWA93I,22686
+bootstack/widgets/_impl/primitives/flexframe.py,sha256=z_XiVjqZep8o_CPd8zeGVmFoDtUg-TUM8n21iGBy5Zo,24830
 bootstack/widgets/_impl/primitives/frame.py,sha256=Q2FWhgGkBU74YgYnKr9TFlkbrf_qXlJES4SZlAmJUNk,7226
 bootstack/widgets/_impl/primitives/gridframe.py,sha256=hr74jDwX9pdw0LquQNANHFkpyubw7vmyX8vUhXI7VfY,21629
 bootstack/widgets/_impl/primitives/label.py,sha256=2XxnObg6xmbLIkefCMYkb9hwyZIuU8FJclvcMpnszW0,3495
 bootstack/widgets/_impl/primitives/labelframe.py,sha256=IB5fqGgwG44vDrszFRBLEqrJGW5IXX1veK5AhetPGOE,2013
-bootstack/widgets/_impl/primitives/optionmenu.py,sha256=cH15ls1msZx74FzWIj3mZdBwBCJ3uYf0iwVbA3mesfQ,16671
+bootstack/widgets/_impl/primitives/optionmenu.py,sha256=xSFuPEEuGeOnv7cCuQIK1R2sP4NrwQdLDxKlFuPJ7lI,16601
 bootstack/widgets/_impl/primitives/packframe.py,sha256=maUgSNlnJFoLr6ErpRMoO4922uJMPrxkfzTkc2jc-tg,8754
 bootstack/widgets/_impl/primitives/panedwindow.py,sha256=kSuXphwDDwITTenmHVMLwevBg5czbeJjJzRHUO504KM,1697
 bootstack/widgets/_impl/primitives/progressbar.py,sha256=Mmj-AUmfQEB671OzDvWxezowcBliZdQkuwWaCHBedmU,3129
@@ -453,10 +453,10 @@ bootstack/widgets/_impl/primitives/sizegrip.py,sha256=uwQRzOEHjNPXtUURhT6k2TNYdy
 bootstack/widgets/_impl/primitives/spinbox.py,sha256=McGzm6WyQWmTtU4Yzx7wdtiPhsZZu4hkJh_IpKR6a1s,4415
 bootstack/widgets/_impl/primitives/switch.py,sha256=7dt43uE2P_WdkxZZsGtCFRAQ20nI2jx5VUqGSrWwEmA,2543
 bootstack/widgets/_impl/primitives/treeview.py,sha256=vnSowgzmtNEWst_i9ZgcacHjdvuheF9xmeTvTWE1bLg,2709
-bootstack-0.4.7.dist-info/licenses/LICENSE,sha256=CUeTPUOM8Qc0yuqneJUwuUmDBooET5UfsHjMrkdBeCg,1097
-bootstack-0.4.7.dist-info/licenses/NOTICE,sha256=c62TcygUKbXx1V3FEgziroDDry_NwmycqKEg_CRnYBU,1503
-bootstack-0.4.7.dist-info/METADATA,sha256=aSm-wNO_I9iVcy6RPaxdPoop-gC7LWpPbsTQArW8Z_A,16107
-bootstack-0.4.7.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-bootstack-0.4.7.dist-info/entry_points.txt,sha256=phOlfRy3Th86IYlNhQiUrTLLLzxie1IG-kMas_5iMdA,49
-bootstack-0.4.7.dist-info/top_level.txt,sha256=IsKBAac2vRCegvRFSCzwcBr7TpHp4bLnLFgA75LOkXs,10
-bootstack-0.4.7.dist-info/RECORD,,
+bootstack-0.4.8.dist-info/licenses/LICENSE,sha256=CUeTPUOM8Qc0yuqneJUwuUmDBooET5UfsHjMrkdBeCg,1097
+bootstack-0.4.8.dist-info/licenses/NOTICE,sha256=c62TcygUKbXx1V3FEgziroDDry_NwmycqKEg_CRnYBU,1503
+bootstack-0.4.8.dist-info/METADATA,sha256=oSwwUata-lhwZVUVdwbrpw6SZRiptwmEyqVieGiTq4k,16107
+bootstack-0.4.8.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+bootstack-0.4.8.dist-info/entry_points.txt,sha256=phOlfRy3Th86IYlNhQiUrTLLLzxie1IG-kMas_5iMdA,49
+bootstack-0.4.8.dist-info/top_level.txt,sha256=IsKBAac2vRCegvRFSCzwcBr7TpHp4bLnLFgA75LOkXs,10
+bootstack-0.4.8.dist-info/RECORD,,