bootstack 0.1.0__py3-none-any.whl

bootstack/style/builders/spinbox.py

@@ -0,0 +1,119 @@
+"""Spinbox widget style builders.
+
+This module contains style builders for ttk.Spinbox widget and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack._core.images import _ImageService
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image
+from bootstack.style.builders.utils import (
+    normalize_button_density,
+    entry_font,
+    entry_padding,
+    entry_icon_size,
+    entry_image_key,
+    spinner_arrow_height,
+    spinner_arrow_width,
+)
+
+
+@StyleBuilderTtk.register_builder('default', 'TSpinbox')
+def build_spinbox_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    fill_token = options.get('input_background') or 'background'
+    density = normalize_button_density(options.get('density', 'default'))
+
+    fill = b.color(fill_token)
+    container_surface = b.color(surface_token)
+    accent_color = b.color(accent or 'primary')
+    foreground = b.on_color(fill)
+
+    normal = fill
+    border = b.border(fill)
+    disabled = b.disabled()
+    focused_border = b.focus_border(accent_color)
+    focused_ring = b.focus_ring(accent_color, container_surface)
+
+    select_background = b.color('primary')
+    select_foreground = b.on_color(select_background)
+    disabled_foreground = b.disabled('text')
+
+    # input elements - use density-aware images from manifest
+    img_key = entry_image_key('input', density)
+    normal_img = recolor_element_image(img_key, normal, border, container_surface, container_surface)
+    focused_img = recolor_element_image(img_key, normal, focused_border, focused_ring, container_surface)
+    disabled_img = recolor_element_image(img_key, disabled, border, container_surface, container_surface)
+
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.field', normal_img.image, sticky='nsew', border=normal_img.meta.border).state_specs(
+            [
+                ('disabled', disabled_img.image),
+                ('readonly', disabled_img.image),
+                ('focus', focused_img.image)
+            ]
+        )
+    )
+
+    # add arrow images - use density-aware icon size (same as combobox)
+    icon_size = entry_icon_size(b, density)
+    arrow_up_normal_img = _ImageService.get_icon('caret-up-fill', icon_size, foreground)
+    arrow_up_disabled_img = _ImageService.get_icon('caret-up-fill', icon_size, disabled_foreground)
+    arrow_down_normal_img = _ImageService.get_icon('caret-down-fill', icon_size, foreground)
+    arrow_down_disabled_img = _ImageService.get_icon('caret-down-fill', icon_size, disabled_foreground)
+
+    # Arrow element images
+    arrow_height = spinner_arrow_height(b, density)
+    arrow_width = spinner_arrow_width(b)
+
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.uparrow', arrow_up_normal_img, sticky='', width=arrow_width, height=arrow_height).state_specs([
+            ('disabled', arrow_up_disabled_img),
+            ('', arrow_up_normal_img),
+        ])
+    )
+
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.downarrow', arrow_down_normal_img, sticky='', width=arrow_width, height=arrow_height).state_specs([
+            ('disabled', arrow_down_disabled_img),
+            ('', arrow_down_normal_img),
+        ])
+    )
+
+    # layout - arrows stacked vertically
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.field', sticky="nsew").children(
+            [
+                Element('null', side='right', sticky='').children(
+                    [
+                        Element(f'{ttk_style}.uparrow', side='top', sticky=''),
+                        Element(f'{ttk_style}.downarrow', side='top', sticky=''),
+                    ]),
+                Element('Spinbox.padding', sticky='nsew').children(
+                    [
+                        Element('Spinbox.textarea', sticky='nsew'),
+                    ])
+            ]),
+    )
+
+    b.configure_style(
+        ttk_style,
+        foreground=foreground,
+        background=fill,
+        padding=entry_padding(b, density),
+        selectforeground=select_foreground,
+        selectbackground=select_background,
+        insertcolor=foreground,
+        selectborderwidth=0,
+        font=entry_font(density)
+    )
+
+    b.map_style(
+        ttk_style,
+        selectforeground=[],
+        selectbackground=[],
+        foreground=[('disabled !readonly', disabled_foreground), ('', foreground)],
+    )

bootstack/style/builders/switch.py

@@ -0,0 +1,70 @@
+"""Switch widget style builders.
+
+This module contains style builders for switch (toggle) variants of ttk.Checkbutton.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import create_transparent_image, mix_colors, recolor_element_image
+
+
+@StyleBuilderTtk.register_builder('switch', 'TCheckbutton')
+def build_switch_style(b: StyleBuilderTtk, ttk_style: str, accent: str = 'primary', **options):
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+
+    background = b.color(surface_token)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled('text', background)
+
+    normal = b.color(accent_token)
+    border = b.border(background)
+    focus = b.focus(normal)
+    focus_ring = b.color('foreground')
+
+    # Disabled ON keeps a muted (faded) accent track so it still reads as "on",
+    # mixed halfway toward the surface; OFF stays a neutral gray track.
+    muted_accent = mix_colors(normal, background, 0.5)
+
+    normal_checked_img = recolor_element_image('switch_on', normal, background, background, background)
+    normal_unchecked_img = recolor_element_image('switch_off', border, background, background, background)
+
+    focus_checked_img = recolor_element_image('switch_on', focus, background, focus_ring, background)
+    focus_unchecked_img = recolor_element_image('switch_off', border, background, focus_ring, background)
+
+    disabled_checked_img = recolor_element_image('switch_on', muted_accent, background, background, background)
+    disabled_unchecked_img = recolor_element_image('switch_off', border, background, background, background)
+
+    spacer_img = create_transparent_image(6, 1)
+    b.create_style_element_image(ElementImage(f'{ttk_style}.spacer', spacer_img, sticky="ew"))
+
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.indicator', normal_unchecked_img.image, sticky="ns").state_specs(
+            [
+                # Disabled states
+                ('disabled selected', disabled_checked_img.image),
+                ('disabled !selected !alternate', disabled_unchecked_img.image),
+
+                # Focused states
+                ('background focus selected', focus_checked_img.image),
+                ('background focus !selected !alternate', focus_unchecked_img.image),
+
+                # Normal base states
+                ('selected', normal_checked_img.image),
+                ('!selected !alternate', normal_unchecked_img.image),
+            ]
+        ))
+
+    b.create_style_layout(
+        ttk_style, Element('Checkbutton.padding', sticky="nsew").children(
+            [
+                Element(f'{ttk_style}.indicator', side="left", sticky=""),
+                Element(f'{ttk_style}.spacer', side="left"),
+                Element('Checkbutton.label', side="left", sticky="nsew")
+            ])
+    )
+
+    b.configure_style(ttk_style, font="body")
+    b.map_style(ttk_style, background=[('', background)], foreground=[('disabled', foreground_disabled), ('', foreground)])

bootstack/style/builders/tabitem.py

@@ -0,0 +1,204 @@
+"""TabItem widget style builders.
+
+This module contains style builders for the TabItem composite widget.
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image
+
+
+def _apply_icon_mapping(b: StyleBuilderTtk, options: dict, state_spec: dict, default_size: int):
+    """Apply icon mapping to the state spec if icon is provided."""
+    icon = options.get('icon')
+    if icon is None:
+        return state_spec
+
+    icon = b.normalize_icon_spec(icon, default_size)
+    state_spec['image'] = b.map_stateful_icons(icon, state_spec['foreground'])
+    icon_only = options.get('icon_only', False)
+    if not icon_only:
+        state_spec['compound'] = 'left'
+    return state_spec
+
+
+@StyleBuilderTtk.register_builder('default', 'TabItem.TFrame')
+def build_tab_item_bar_frame(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """TabItem frame style for bar/underline variant."""
+    orient = options.get('orient', 'horizontal')
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    accent_color = b.color(accent_token)
+    accent_subtle = b.subtle(accent_token, surface)
+
+    image_key = f'tab_{orient}'
+    normal_img = recolor_element_image(image_key, surface, surface, surface)
+    active_img = recolor_element_image(image_key, accent_subtle, accent_subtle, accent_subtle)
+    selected_img = recolor_element_image(image_key, surface, accent_color, accent_color)
+    selected_hover_img = recolor_element_image(image_key, accent_subtle, accent_color, accent_color)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border', normal_img.image, sticky='nsew', border=normal_img.meta.border
+        ).state_specs([
+            ('selected hover', selected_hover_img.image),
+            ('selected', selected_img.image),
+            ('hover', active_img.image),
+            ('', normal_img.image),
+        ])
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.border', sticky='nsew').children([
+            Element(f'{ttk_style}.padding', sticky='nsew')
+        ])
+    )
+
+    b.configure_style(ttk_style, background=surface, relief='flat')
+
+
+@StyleBuilderTtk.register_builder('default', 'TabItem.TLabel')
+def build_tab_item_bar_label(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """TabItem label style for bar/underline variant."""
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    accent_subtle = b.subtle(accent_token, surface)
+    on_surface = b.on_color(surface)
+    on_disabled = b.disabled('text', surface)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        padding=0,
+        font='body'
+    )
+
+    state_spec = dict(
+        foreground=[('disabled', on_disabled), ('', on_surface)],
+        background=[
+            ('selected hover', accent_subtle),
+            ('selected', surface),
+            ('hover', accent_subtle),
+            ('', surface),
+        ]
+    )
+    state_spec = _apply_icon_mapping(b, options, state_spec, 18)
+    b.map_style(ttk_style, **state_spec)
+
+
+# --- TabItem.TButton builders (for close button) ---
+
+def _build_tab_item_button_layout(b: StyleBuilderTtk, ttk_style: str):
+    """Create standard button layout for TabItem close buttons."""
+    b.create_style_layout(
+        ttk_style,
+        Element('Label.border', sticky='nsew').children([
+            Element('Label.padding', sticky='nsew').children([
+                Element('Label.label', sticky='nsew')
+            ])
+        ])
+    )
+
+
+@StyleBuilderTtk.register_builder('default', 'TabItem.TButton')
+def build_tab_item_bar_button(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """TabItem close button style for bar variant - matches frame background."""
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    closable = options.get('closable')
+
+    surface = b.color(surface_token)
+    accent_subtle = b.subtle(accent_token, surface)
+    on_surface = b.on_color(surface)
+    on_disabled = b.disabled('text', surface)
+
+    _build_tab_item_button_layout(b, ttk_style)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        padding=0,
+        relief='flat',
+        stipple='gray12',
+        font='body',
+    )
+
+    # When closable='hover', hide icon by matching foreground to background in non-hover states
+    if closable == 'hover':
+        state_spec = dict(
+            foreground=[
+                ('disabled', surface),
+                ('hover', on_surface),
+                ('', surface)
+            ],
+            background=[
+                ('selected hover', accent_subtle),
+                ('selected', surface),
+                ('hover', accent_subtle),
+                ('', surface)
+            ]
+        )
+    else:
+        state_spec = dict(
+            foreground=[
+                ('disabled', on_disabled),
+                ('', on_surface)
+            ],
+            background=[
+                ('selected hover', accent_subtle),
+                ('selected', surface),
+                ('hover', accent_subtle),
+                ('', surface)
+            ]
+        )
+
+    state_spec = _apply_icon_mapping(b, options, state_spec, 12)
+    b.map_style(ttk_style, **state_spec)
+
+
+@StyleBuilderTtk.register_builder('icon', 'TabItem.TButton')
+def build_tab_item_icon_button(b: StyleBuilderTtk, ttk_style: str, _: Optional[str] = None, **options):
+    """TabItem close button style - generic icon only button (fallback)."""
+    surface_token = options.get('surface', 'content')
+
+    background = b.color(surface_token)
+    active = b.elevate(background, 1)
+    pressed = b.pressed(background)
+    on_background = b.on_color(background)
+    on_disabled = b.disabled('text', background)
+
+    _build_tab_item_button_layout(b, ttk_style)
+
+    b.configure_style(
+        ttk_style,
+        background=background,
+        foreground=on_background,
+        padding=0,
+        relief='flat',
+        stipple='gray12',
+        font='body',
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('', on_background)
+        ],
+        background=[
+            ('pressed', pressed),
+            ('hover', active),
+        ]
+    )
+
+    state_spec = _apply_icon_mapping(b, options, state_spec, 12)
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/togglegroup.py

@@ -0,0 +1,294 @@
+"""ToggleGroup widget style builders.
+
+Duplicated from the ButtonGroup builder so selection widgets (ToggleGroup) can
+diverge from action widgets (ButtonGroup) — they need different normal states.
+The baked nine-patch shapes are shared (the `button_group_*` image keys); only
+the colors/state mappings differ.
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.builders.utils import button_padding, apply_icon_mapping, icon_size, button_font
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image
+
+
+def _toolbutton_layout(ttk_style: str) -> Element:
+    return Element(f"{ttk_style}.border", sticky="nsew").children(
+        [
+            Element("Toolbutton.padding", sticky="nsew").children(
+                [
+                    Element("Toolbutton.label", sticky="nsew")
+                ])
+        ])
+
+
+@StyleBuilderTtk.register_builder('solid', 'ToggleGroup')
+@StyleBuilderTtk.register_builder('default', 'ToggleGroup')
+def build_toggle_group_style(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """
+    Configure the toggle group style.
+
+    Style options include:
+        * icon_only
+        * position
+        * orientation
+        * active_state
+        * density
+    """
+    accent = b.default(accent)
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'horizontal')
+    position = options.get('position', 'before')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    active_state = options.get('active_state', False)
+    image_key = f'button_group_{orient}_{position}_{density}'
+
+    surface = b.color(surface_token)
+    accent_color = b.elevate(surface, 2) if accent is None else b.color(accent)
+
+    # background colors
+    bg_normal = b.elevate(surface, 1)
+    bg_selected = accent_color
+    bg_disabled = b.disabled()
+
+    # foreground colors
+    fg_normal = b.muted_foreground(bg_normal)
+    fg_selected = b.on_color(bg_selected)
+    fg_disabled = b.disabled('text', bg_disabled)
+
+    # border colors
+    bd_normal = b.border(bg_normal)
+    bd_selected = b.border(bg_selected)
+    bd_disabled = b.border(bg_disabled)
+
+    normal_img = recolor_element_image(image_key, bg_normal, bd_normal, surface, surface)
+    selected_img = recolor_element_image(image_key, bg_selected, bd_selected, surface, surface)
+    disabled_img = recolor_element_image(image_key, bg_disabled, bd_disabled, surface, surface)
+
+    if active_state:
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.border', normal_img.image, sticky="nsew", border=normal_img.meta.border).state_specs(
+                [
+                    ('disabled', disabled_img.image),
+                    ('selected', selected_img.image),
+                    ('', normal_img.image)
+                ]))
+    else:
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.border', normal_img.image, sticky="nsew", border=normal_img.meta.border).state_specs(
+                [
+                    ('disabled', disabled_img.image),
+                    ('selected', selected_img.image),
+                    ('', normal_img.image)
+                ]))
+
+    b.create_style_layout(
+        ttk_style,
+        _toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=fg_normal,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor="center",
+        font=button_font(density)
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', fg_disabled),
+            ('selected', fg_selected),
+            ('', fg_normal)],
+    )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+    b.map_style(ttk_style, **state_spec)
+
+
+@StyleBuilderTtk.register_builder('outline', 'ToggleGroup')
+def build_outline_toggle_group_style(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """
+    Configure the outline toggle group style.
+
+    Style options include:
+        * icon_only
+        * position
+        * orientation
+        * active_state
+        * density
+    """
+    accent = b.default(accent)
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'horizontal')
+    position = options.get('position', 'before')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    active_state = options.get('active_state', False)
+    image_key = f'button_group_{orient}_{position}_{density}'
+
+    surface = b.color(surface_token)
+    accent_color = b.elevate(surface, 1) if accent is None else b.color(accent)
+
+    # background colors
+    bg_normal = surface
+    bg_selected = accent_color
+    bg_disabled = b.disabled()
+
+    # foreground colors
+    fg_normal = b.muted_foreground(bg_normal) if accent is None else accent_color
+    fg_selected = b.on_color(bg_selected)
+    fg_disabled = b.disabled('text', bg_disabled)
+
+
+    # border colors
+    bd_normal = b.border(bg_normal) if accent is None else accent_color
+    bd_selected = b.border(bg_selected)
+    bd_disabled = b.border(bg_disabled)
+
+
+    normal_img = recolor_element_image(image_key, surface, bd_normal, surface, surface)
+    selected_img = recolor_element_image(image_key, bg_selected, bd_selected, surface, surface)
+    disabled_img = recolor_element_image(image_key, bg_disabled, bd_disabled, surface, surface)
+
+    if active_state:
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.border', normal_img.image, sticky="nsew", border=normal_img.meta.border).state_specs(
+                [
+                    ('disabled', disabled_img.image),
+                    ('selected', selected_img.image),
+                    ('', normal_img.image)
+                ]))
+    else:
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.border', normal_img.image, sticky="nsew", border=normal_img.meta.border).state_specs(
+                [
+                    ('disabled', disabled_img.image),
+                    ('selected', selected_img.image),
+                    ('', normal_img.image)
+                ]))
+
+    b.create_style_layout(
+        ttk_style,
+        _toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=fg_normal,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor="center",
+        font=button_font(density)
+    )
+
+    if active_state:
+        state_spec = dict(
+            foreground=[
+                ('disabled', fg_disabled),
+                ('selected', fg_selected),
+                ('', fg_normal)],
+        )
+    else:
+        state_spec = dict(
+            foreground=[
+                ('disabled', fg_disabled),
+                ('selected', fg_selected),
+                ('', fg_normal)],
+        )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+    b.map_style(ttk_style, **state_spec)
+
+
+@StyleBuilderTtk.register_builder('ghost', 'ToggleGroup')
+def build_ghost_toggle_group_style(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """
+    Configure the ghost toggle group style.
+
+    Style options include:
+        * icon_only
+        * position
+        * orientation
+        * active_state
+        * density
+    """
+    accent = b.default(accent)
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'horizontal')
+    position = options.get('position', 'before')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    image_key = f'button_group_{orient}_{position}_{density}'
+
+    surface = b.color(surface_token)
+    accent_color = b.elevate(surface, 1) if accent is None else b.color(accent)
+
+    # background colors
+    bg_normal = surface
+    bg_selected = b.elevate(surface, 2) if accent is None else b.subtle(accent, surface)
+    bg_disabled = b.disabled()
+
+    # foreground colors
+    fg_normal = b.muted_foreground(bg_normal)
+    fg_selected = b.on_color(bg_selected) if accent is None else accent_color
+    fg_disabled = b.disabled('text', bg_disabled)
+
+    # border colors
+    bd_normal = b.border(surface)
+    bd_selected = b.border(bg_selected)
+
+    # button images
+    normal_img = recolor_element_image(image_key, bg_normal, bd_normal, surface, surface)
+    selected_img = recolor_element_image(image_key, bg_selected, bd_selected, surface, surface)
+    disabled_img = recolor_element_image(image_key, surface, bg_normal, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border', normal_img.image, sticky="nsew", border=normal_img.meta.border).state_specs(
+            [
+                ('disabled', disabled_img.image),
+                ('selected', selected_img.image),
+                ('', normal_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style,
+        _toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=fg_normal,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor="center",
+        font=button_font(density)
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', fg_disabled),
+            ('selected !disabled', fg_selected),
+            ('', fg_normal)
+        ]
+    )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+    b.map_style(ttk_style, **state_spec)