bootstack 0.1.0__py3-none-any.whl

bootstack/widgets/_impl/primitives/progressbar.py

@@ -0,0 +1,83 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing import Any, Literal, TYPE_CHECKING
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets._impl.mixins.configure_mixin import configure_delegate
+from bootstack.widgets.types import Master, StyledKwargs, Orient
+from ..mixins import SignalMixin
+
+if TYPE_CHECKING:
+    from bootstack.signals import Signal
+
+
+class ProgressbarKwargs(StyledKwargs, total=False):
+    # Standard ttk.Progressbar options
+    mode: Literal['determinate', 'indeterminate'] | str
+    orient: Orient
+    length: Any
+    maximum: float
+    value: float
+    variable: Any
+    signal: Signal[Any]
+    phase: int
+
+    # bootstack-specific extensions
+
+
+class Progressbar(SignalMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Progressbar):
+    """bootstack wrapper for `ttk.Progressbar` with themed styling support."""
+
+    _ttk_base = ttk.Progressbar
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[ProgressbarKwargs]) -> None:
+        """Create a themed bootstack Progressbar.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            mode: Progress mode ('determinate' or 'indeterminate').
+            orient: Orientation of the bar ('horizontal' or 'vertical').
+            length: Requested length of the progress bar in pixels.
+            maximum: Maximum value.
+            value: Current value.
+            variable: Tk variable linked to the value.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            signal: Reactive Signal linked to the value (auto-synced with variable).
+            phase: Animation phase for indeterminate mode.
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling, e.g. 'primary', 'success', 'danger'.
+            variant: Style variant, e.g. 'default', 'thin'.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        super().__init__(master, **kwargs)
+
+    def get(self) -> float:
+        """Return the current progress value."""
+        return float(ttk.Progressbar.cget(self, 'value'))
+
+    def set(self, value: float) -> None:
+        """Set the progress value."""
+        ttk.Progressbar.configure(self, value=value)
+
+    @property
+    def value(self) -> float:
+        """Get or set the progress value."""
+        return self.get()
+
+    @value.setter
+    def value(self, value: float) -> None:
+        self.set(value)
+
+    @configure_delegate('value')
+    def _delegate_value(self, value=None):
+        """Get or set the value via configure."""
+        if value is None:
+            return self.get()
+        self.set(value)

bootstack/widgets/_impl/primitives/radiobutton.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing import Any, Callable, Literal, TYPE_CHECKING
+
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets._impl.mixins import IconMixin, LocalizationMixin, SignalMixin, TextSignalMixin
+from bootstack.widgets._impl.mixins.configure_mixin import configure_delegate
+from bootstack.widgets.types import Master, StyledKwargs, Anchor, CompoundMode, WidgetState
+
+if TYPE_CHECKING:
+    from bootstack.signals import Signal
+
+
+class RadioButtonKwargs(StyledKwargs, total=False):
+    # Standard ttk.Radiobutton options
+    text: Any
+    command: Callable[[], Any] | None
+    image: Any
+    icon: Any
+    on_icon: Any
+    off_icon: Any
+    icon_only: bool
+    show_indicator: bool
+    compound: CompoundMode
+    variable: Any
+    signal: Signal[Any]
+    value: Any
+    padding: Any
+    anchor: Anchor
+    width: int
+    underline: int
+    state: WidgetState
+    textvariable: Any
+    textsignal: Signal[str]
+
+    # bootstack-specific extensions
+    localize: bool | Literal['auto']
+
+
+class RadioButton(LocalizationMixin, SignalMixin, TextSignalMixin, IconMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Radiobutton):
+    """bootstack wrapper for `ttk.Radiobutton` with themed styling and icon support."""
+
+    _ttk_base = ttk.Radiobutton
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[RadioButtonKwargs]) -> None:
+        """Create a themed bootstack Radiobutton.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            text: Text to display.
+            textvariable: Tk variable linked to the text.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            textsignal: Reactive Signal linked to the text (auto-synced with textvariable).
+            command: Callable invoked when the value is selected.
+            image: Image to display.
+            icon: Icon shown in the label area for all states. Color shifts
+                from foreground (unselected) to accent (selected) automatically.
+            on_icon: Icon shown in the label area when the button is selected.
+                Shortcut for `state=[("selected", name)]` inside a full icon spec.
+            off_icon: Icon shown in the label area when the button is unselected.
+                Used as the base icon when `on_icon` is also provided.
+            icon_only: Removes the additional padding added for label.
+            show_indicator: Whether to show the standard radio indicator. Defaults
+                to True. Set to False to hide the indicator (e.g. for icon-only radio groups).
+            compound: Placement of the image relative to text.
+            variable: Linked Tk variable that receives the selected value.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            signal: Reactive Signal that receives the selected value (auto-synced with variable).
+            value: The value assigned to `variable` when this radio is selected.
+            padding: Extra space around the content.
+            anchor: Determines how the content is aligned in the container. Combination of 'n', 's', 'e', 'w', or 'center' (default).
+            width: Width of the control in characters.
+            underline: Index of character to underline in `text`.
+            state: Widget state.
+            takefocus: Whether the widget participates in focus traversal.
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling, e.g. 'primary', 'success', 'danger'.
+            variant: Style variant, e.g. 'default'.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+            localize: Determines the widget's localization mode.
+        """
+        kwargs.update(style_options=self._capture_style_options(['icon_only', 'icon', 'on_icon', 'off_icon', 'show_indicator', 'anchor'], kwargs))
+        super().__init__(master, **kwargs)
+
+    def get(self) -> Any:
+        """Return the current selected value."""
+        return self.variable.get()
+
+    def set(self, value: Any) -> None:
+        """Set the selected value."""
+        self.variable.set(value)
+
+    @property
+    def value(self) -> Any:
+        """Get or set the radiobutton's selected value."""
+        return self.get()
+
+    @value.setter
+    def value(self, value: Any) -> None:
+        self.set(value)
+
+    @configure_delegate('value')
+    def _delegate_value(self, value=None):
+        """Get or set the value via configure."""
+        if value is None:
+            return self.get()
+        self.set(value)

bootstack/widgets/_impl/primitives/radiotoggle.py

@@ -0,0 +1,54 @@
+from typing import Literal
+
+from typing_extensions import Unpack
+
+from bootstack.widgets._impl.primitives.radiobutton import RadioButton, RadioButtonKwargs
+from bootstack.widgets.types import Master
+
+
+class RadioToggle(RadioButton):
+    """bootstack wrapper for `ttk.Radiobutton` that renders with a toggle badge style."""
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[RadioButtonKwargs]) -> None:
+        """Create a themed bootstack RadioToggle.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            text: Text to display.
+            textvariable: Tk variable linked to the text.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            textsignal: Reactive Signal linked to the text (auto-synced with textvariable).
+            command: Callable invoked when the value is selected.
+            image: Image to display.
+            icon: Theme-aware icon spec handled by the style system.
+            icon_only: Removes the additional padding added for label text.
+            compound: Placement of the image relative to text.
+            variable: Linked Tk variable that receives the selected value.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            signal: Reactive Signal that receives the selected value (auto-synced with variable).
+            value: The value assigned to `variable` when this radio is selected.
+            padding: Extra space around the content.
+            anchor: Determines how the content is aligned in the container. Combination of 'n', 's', 'e', 'w', or 'center' (default).
+            density: The vertical and horizontal compactness of widget content, e.g. 'default', 'compact'.
+            width: Width of the control in characters.
+            underline: Index of character to underline in `text`.
+            state: Widget state ('normal', 'active', 'disabled', 'readonly').
+            takefocus: Whether the widget participates in focus traversal.
+            accent: Accent token for styling, e.g. 'primary', 'success', 'danger'.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+            localize: Determines the widget's localization mode.
+        """
+        self._capture_density_option(kwargs)
+        kwargs.setdefault('ttk_class', 'Toolbutton')
+        super().__init__(master, **kwargs)
+
+    @staticmethod
+    def _capture_density_option(kwargs: dict) -> None:
+        """Capture density from kwargs into style_options."""
+        density: Literal['default', 'compact'] | None = kwargs.pop('density', None)
+        if density is not None:
+            style_options = kwargs.setdefault('style_options', {})
+            style_options['density'] = density

bootstack/widgets/_impl/primitives/scrollbar.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing import Any
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets.types import Master, StyledKwargs, Orient
+
+
+class ScrollbarKwargs(StyledKwargs, total=False):
+    # Standard ttk.Scrollbar options
+    orient: Orient
+    command: Any
+
+    # bootstack-specific extensions
+
+
+class Scrollbar(TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Scrollbar):
+    """bootstack wrapper for `ttk.Scrollbar` with themed styling support."""
+
+    _ttk_base = ttk.Scrollbar
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[ScrollbarKwargs]) -> None:
+        """Create a themed bootstack Scrollbar.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            orient: Orientation of the scrollbar ('horizontal' or 'vertical').
+            command: Scroll command callback.
+            takefocus: Whether the widget participates in focus traversal.
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling, e.g. 'primary', 'danger', 'success'.
+            variant: Style variant — 'default' (rounded) or 'thin' (slim square).
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        super().__init__(master, **kwargs)

bootstack/widgets/_impl/primitives/separator.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets.types import Master, StyledKwargs, Orient
+
+
+class SeparatorKwargs(StyledKwargs, total=False):
+    # Standard ttk.Separator options
+    orient: Orient
+
+    # bootstack-specific extensions
+    thickness: int
+    length: int
+
+
+class Separator(TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Separator):
+    """bootstack wrapper for `ttk.Separator` with themed styling support."""
+
+    _ttk_base = ttk.Separator
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[SeparatorKwargs]) -> None:
+        """Create a themed bootstack Separator.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            orient: Orientation of the separator ('horizontal' or 'vertical').
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling, e.g. 'primary', 'secondary'; otherwise derived from the inherited surface.
+            surface: Optional surface token; otherwise inherited.
+            thickness: Thickness of the separator.
+            length: Fixed length of the separator in pixels. If None,
+                stretches to fill available space.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        kwargs.update(style_options=self._capture_style_options(['thickness', 'length', 'border_strength'], kwargs))
+        super().__init__(master, **kwargs)

bootstack/widgets/_impl/primitives/sizegrip.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets.types import Master, StyledKwargs
+
+
+class SizeGripKwargs(StyledKwargs, total=False):
+    pass
+
+
+class SizeGrip(TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Sizegrip):
+    """bootstack wrapper for `ttk.Sizegrip` with themed styling support."""
+
+    _ttk_base = ttk.Sizegrip
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[SizeGripKwargs]) -> None:
+        """Create a themed bootstack Sizegrip.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        super().__init__(master, **kwargs)

bootstack/widgets/_impl/primitives/spinbox.py

@@ -0,0 +1,95 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing import Any, TYPE_CHECKING
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets.types import Master, StyledKwargs, WidgetState, WidgetDensity
+from ..mixins import TextSignalMixin, configure_delegate
+
+if TYPE_CHECKING:
+    from bootstack.signals import Signal
+
+
+class SpinboxKwargs(StyledKwargs, total=False):
+    # Standard ttk.Spinbox options
+    from_: float
+    to: float
+    increment: float
+    values: Any
+    wrap: bool
+    command: Any
+    font: Any
+    textvariable: Any
+    textsignal: Signal[Any]
+    format: str
+    width: int
+    state: WidgetState
+
+    # bootstack-specific extensions
+    density: WidgetDensity
+
+
+class Spinbox(TextSignalMixin, TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Spinbox):
+    """bootstack wrapper for `ttk.Spinbox` with themed styling support."""
+
+    _ttk_base = ttk.Spinbox
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[SpinboxKwargs]) -> None:
+        """Create a themed bootstack Spinbox.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            from_: Minimum value.
+            to: Maximum value.
+            increment: Step size between values.
+            values: Sequence of values to cycle through.
+            wrap: Whether to wrap between min/max.
+            command: Callback when the value changes.
+            textvariable: Tk variable linked to the entry text.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            textsignal: Reactive Signal linked to the text (auto-synced with textvariable).
+            format: Display format string.
+            width: Widget width in characters.
+            state: Widget state.
+            takefocus: Whether the widget participates in focus traversal.
+            style: Explicit ttk style name (overrides accent/variant).
+            accent: Accent token for styling, e.g. 'primary', 'danger', 'success'.
+            density: Vertical and horizontal compactness, e.g. 'default', 'compact'.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        if kwargs.get('density') == 'compact':
+            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.
+        self.bind("<MouseWheel>", self._on_mousewheel)
+        self.bind("<Button-4>", self._on_mousewheel)
+        self.bind("<Button-5>", self._on_mousewheel)
+
+    def _on_mousewheel(self, event):
+        if event.delta > 0 or event.num == 4:
+            self.event_generate("<Up>")
+        else:
+            self.event_generate("<Down>")
+        return "break"
+
+
+    @configure_delegate('density')
+    def _delegate_density(self, value=None):
+        if value is None:
+            return self.configure_style_options(value)
+        else:
+            if value == 'compact':
+                self.configure(font='caption')
+            else:
+                self.configure(font='body')
+            return self.configure_style_options(density=value)

bootstack/widgets/_impl/primitives/switch.py

@@ -0,0 +1,44 @@
+from typing_extensions import Unpack
+
+from bootstack.widgets._impl.primitives.checkbutton import CheckButton, CheckButtonKwargs
+from bootstack.widgets.types import Master
+
+
+class Switch(CheckButton):
+    """bootstack wrapper for `ttk.Checkbutton` that renders with a Switch style"""
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[CheckButtonKwargs]) -> None:
+        """Create a themed bootstack Switch.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            text: Text to display on the toggle.
+            textvariable: Tk variable linked to the text.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            textsignal: Reactive Signal linked to the text (auto-synced with textvariable).
+            command: Callable invoked when the toggle changes state.
+            image: Image to display.
+            icon: Theme-aware icon spec handled by the style system.
+            icon_only: If True, removes the additional padding reserved for text.
+            compound: Placement of the image relative to text.
+            variable: Linked variable controlling the on/off state.
+                See [tkinter Variables](https://docs.python.org/3/library/tkinter.html#tkinter-variables).
+            signal: Reactive Signal controlling the on/off state (auto-synced with variable).
+            value: Initial state for the widget's associated variable (defaults to None when unset).
+            onvalue: Value set in `variable` when selected.
+            offvalue: Value set in `variable` when deselected.
+            padding: Extra space around the content.
+            anchor: Determines how the content is aligned in the container. Combination of 'n', 's', 'e', 'w', or 'center' (default).
+            width: Width of the control in characters.
+            underline: Index of character to underline in `text`.
+            state: Widget state ('normal', 'active', 'disabled', 'readonly').
+            takefocus: Whether the widget participates in focus traversal.
+            accent: Accent token for styling, e.g. 'primary', 'success', 'danger'.
+            surface: Optional surface token; otherwise inherited.
+            style_options: Optional dict forwarded to the style builder.
+            localize: Determines the widget's localization mode.
+        """
+        kwargs['variant'] = 'switch'
+        super().__init__(master, **kwargs)

bootstack/widgets/_impl/primitives/treeview.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from tkinter import ttk
+from typing import Any, Literal
+from typing_extensions import Unpack
+
+from bootstack._core.mixins.ttk_state import TtkStateMixin
+from bootstack._core.mixins.widget import WidgetCapabilitiesMixin
+from bootstack.widgets._impl._internal.wrapper_base import TTKWrapperBase
+from bootstack.widgets.types import Master, StyledKwargs, WidgetDensity
+
+
+class TreeViewKwargs(StyledKwargs, total=False):
+    # Standard ttk.Treeview options
+    columns: Any
+    displaycolumns: Any
+    show: Literal['tree', 'headings', '']
+    height: int
+    padding: Any
+    selectmode: Literal['browse','extended','none'] | str
+
+    # bootstack-specific extensions
+    density: WidgetDensity
+    border_color: str
+    show_border: bool
+    select_background: str
+    header_background: str
+
+
+class TreeView(TTKWrapperBase, WidgetCapabilitiesMixin, TtkStateMixin, ttk.Treeview):
+    """bootstack wrapper for `ttk.Treeview` with themed styling support."""
+
+    _ttk_base = ttk.Treeview
+
+    def __init__(self, master: Master = None, **kwargs: Unpack[TreeViewKwargs]) -> None:
+        """Create a themed bootstack Treeview.
+
+        Args:
+            master: Parent widget. If None, uses the default root window.
+
+        Other Parameters:
+            columns: Sequence of column identifiers.
+            displaycolumns: Subset and order of columns to display.
+            show: Which parts to display (e.g., 'tree', 'headings').
+            height: Number of rows to display.
+            padding: Extra padding around the widget.
+            selectmode: Selection mode ('browse', 'extended', 'none').
+            style: Explicit ttk style name.
+            surface: Optional surface token; otherwise inherited.
+            density: Compactness of widget content ('default' or 'compact').
+            border_color: Color of the border around the table.
+            show_border: Whether to show a border around the table.
+            open_icon: Icon used for the open state.
+            close_icon: Icon used for the close state.
+            select_background: Semantic color token for selection background.
+            header_background: Semantic color token for the header background.
+            style_options: Optional dict forwarded to the style builder.
+        """
+        kwargs.update(style_options=self._capture_style_options([
+            'density',
+            'border_color',
+            'show_border',
+            'open_icon',
+            'close_icon',
+            'select_background',
+            'header_background'
+        ],
+            kwargs))
+        super().__init__(master, **kwargs)