bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/sidenav.py

@@ -0,0 +1,313 @@
+"""Style builders for SideNav widget components.
+
+This module provides navigation-specific styling with selection indicator bars.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image
+from bootstack.style.builders.utils import apply_icon_mapping
+from bootstack.style.builders.toolbutton import (
+    toolbutton_layout, button_padding, button_font, icon_size, normalize_button_density
+)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'NavigationView.TFrame')
+def build_navigationview_frame_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Build SideNav frame style for group expanders.
+
+    Uses standard button assets (no selection indicator needed since
+    groups don't get selected, only their child items do).
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    image_key = f'button_{density}'
+
+    surface = b.color(surface_token)
+    surface_hover = b.color(f'{surface_token}_hover') if b.colors.get(f'{surface_token}_hover') else b.subtle('secondary', surface)
+    surface_pressed = b.pressed(surface_hover)
+
+    disabled = b.disabled()
+
+    normal_img = recolor_element_image(image_key, surface, surface, surface, surface)
+    hover_img = recolor_element_image(image_key, surface_hover, surface_hover, surface, surface)
+    pressed_img = recolor_element_image(image_key, surface_pressed, surface_pressed, surface, surface)
+    disabled_img = recolor_element_image(image_key, disabled, disabled, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border', normal_img.image, sticky="nsew",
+            border=normal_img.meta.border, padding=normal_img.meta.border
+        ).state_specs(
+            [
+                ('disabled', disabled_img.image),
+                ('pressed', pressed_img.image),
+                ('hover', hover_img.image),
+                ('', normal_img.image)
+            ]))
+
+    # Create layout to use the image-based border
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.border', sticky="nsew")
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        relief='flat',
+    )
+
+
+@BootstyleBuilderTTk.register_builder('default', 'NavigationView.TLabel')
+def build_navigationview_label_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Build SideNav label style with state-aware foreground colors.
+
+    Matches the ghost Toolbutton foreground color behavior.
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+
+    surface = b.color(surface_token)
+    surface_hover = b.color(f'{surface_token}_hover') if b.colors.get(f'{surface_token}_hover') else b.subtle('secondary', surface)
+    surface_pressed = b.pressed(surface_hover)
+    on_surface = b.on_color(surface)
+
+    accent_color = b.color(accent_token)
+    active = b.subtle(accent_token, surface)
+
+    on_disabled = b.disabled('text', surface)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        font='body'
+    )
+
+    foreground_state_map = [
+        ('disabled', on_disabled),
+        ('selected', accent_color),
+        ('', on_surface)
+    ]
+
+    background_state_map = [
+        ('selected', active),
+        ('disabled', surface),
+        ('pressed !selected', surface_pressed),
+        ('hover !selected', surface_hover),
+        ('', surface)
+    ]
+
+    state_spec = dict(foreground=foreground_state_map, background=background_state_map)
+    state_spec = apply_icon_mapping(b, options, state_spec)
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('navigation', 'Toolbutton')
+def build_navigation_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Build navigation Toolbutton style with selection indicator.
+
+    Uses nav-button assets with a left-side selection indicator bar
+    that shows the accent color when selected.
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    anchor = options.get('anchor', 'center' if icon_only else 'w')
+    # Use lighter indicator assets for icon-only buttons
+    asset_prefix = 'nav_icon_button' if icon_only else 'nav_button'
+    image_key = f'{asset_prefix}_{normalize_button_density(density)}'
+
+    surface = b.color(surface_token)
+    surface_hover = b.color(f'{surface_token}_hover') if b.colors.get(f'{surface_token}_hover') else b.subtle('secondary', surface)
+    surface_pressed = b.pressed(surface_hover)
+    on_surface = b.on_color(surface)
+
+    active = b.subtle(accent_token, surface)
+    accent_color = b.color(accent_token)
+    accent_pressed = b.pressed(active)
+
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    # Normal states: indicator hidden (same color as button background)
+    normal_img = recolor_element_image(image_key, surface, surface, surface, surface)
+    hover_img = recolor_element_image(image_key, surface_hover, surface_hover, surface_hover, surface)
+    pressed_img = recolor_element_image(image_key, surface_pressed, surface_pressed, surface_pressed, surface)
+
+    # Selected states: indicator visible (accent color)
+    selected_img = recolor_element_image(image_key, active, active, accent_color, surface)
+    selected_hover_img = recolor_element_image(image_key, active, active, accent_color, surface)
+    selected_pressed_img = recolor_element_image(image_key, accent_pressed, accent_pressed, accent_color, surface)
+
+    disabled_img = recolor_element_image(image_key, disabled, disabled, disabled, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border', normal_img.image, sticky="nsew",
+            border=normal_img.meta.border, padding=normal_img.meta.border
+        ).state_specs(
+            [
+                ('disabled', disabled_img.image),
+                ('selected pressed', selected_pressed_img.image),
+                ('selected hover', selected_hover_img.image),
+                ('selected', selected_img.image),
+                ('pressed', pressed_img.image),
+                ('hover', hover_img.image),
+                ('', normal_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style,
+        toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor=anchor,
+        font=button_font(density)
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('selected', accent_color),
+            ('', on_surface)
+        ],
+    )
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'NavigationButton.TFrame')
+def build_navigationbutton_frame_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Build NavigationButton frame style with selection indicator.
+
+    Uses nav-button assets with a left-side selection indicator bar
+    that shows the accent color when selected. This is the container
+    frame for the composite navigation button.
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    # Use lighter indicator assets for icon-only (compact) mode
+    asset_prefix = 'nav_icon_button' if icon_only else 'nav_button'
+    image_key = f'{asset_prefix}_{normalize_button_density(density)}'
+
+    surface = b.color(surface_token)
+    surface_hover = b.color(f'{surface_token}_hover') if b.colors.get(f'{surface_token}_hover') else b.subtle('secondary', surface)
+    surface_pressed = b.pressed(surface_hover)
+
+    active = b.subtle(accent_token, surface)
+    accent_color = b.color(accent_token)
+    accent_pressed = b.pressed(active)
+
+    disabled = b.disabled()
+
+    # Normal states: indicator hidden (same color as button background)
+    normal_img = recolor_element_image(image_key, surface, surface, surface, surface)
+    hover_img = recolor_element_image(image_key, surface_hover, surface_hover, surface_hover, surface)
+    pressed_img = recolor_element_image(image_key, surface_pressed, surface_pressed, surface_pressed, surface)
+
+    # Selected states: indicator visible (accent color)
+    selected_img = recolor_element_image(image_key, active, active, accent_color, surface)
+    selected_hover_img = recolor_element_image(image_key, active, active, accent_color, surface)
+    selected_pressed_img = recolor_element_image(image_key, accent_pressed, accent_pressed, accent_color, surface)
+
+    disabled_img = recolor_element_image(image_key, disabled, disabled, disabled, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border', normal_img.image, sticky="ew",
+            border=normal_img.meta.border
+        ).state_specs(
+            [
+                ('disabled', disabled_img.image),
+                ('selected pressed', selected_pressed_img.image),
+                ('selected hover', selected_hover_img.image),
+                ('selected', selected_img.image),
+                ('pressed', pressed_img.image),
+                ('hover', hover_img.image),
+                ('', normal_img.image)
+            ]))
+
+    # Create layout to use the image-based border
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.border', sticky="nsew")
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        relief='flat',
+    )
+
+
+@BootstyleBuilderTTk.register_builder('default', 'NavigationButton.TLabel')
+def build_navigationbutton_label_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Build NavigationButton label style with state-aware colors.
+
+    Labels inside the navigation button container that respond to
+    hover, pressed, and selected states.
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    icon_only = options.get('icon_only', False)
+    density = options.get('density', 'default')
+
+    surface = b.color(surface_token)
+    surface_hover = b.color(f'{surface_token}_hover') if b.colors.get(f'{surface_token}_hover') else b.subtle('secondary', surface)
+    surface_pressed = b.pressed(surface_hover)
+    on_surface = b.on_color(surface)
+
+    accent_color = b.color(accent_token)
+    active = b.subtle(accent_token, surface)
+    active_pressed = b.pressed(active)
+
+    on_disabled = b.disabled('text', surface)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        font='body'
+    )
+
+    foreground_state_map = [
+        ('disabled', on_disabled),
+        ('selected', accent_color),
+        ('', on_surface)
+    ]
+
+    background_state_map = [
+        ('disabled', surface),
+        ('selected pressed', active_pressed),
+        ('selected', active),
+        ('pressed !selected', surface_pressed),
+        ('hover !selected', surface_hover),
+        ('', surface)
+    ]
+
+    state_spec = dict(foreground=foreground_state_map, background=background_state_map)
+
+    # Navigation icons use a smaller size than standalone icon buttons
+    # to stay visually consistent with context menu popup icons
+    nav_icon_size = 20 if icon_only else icon_size(icon_only, density)
+    state_spec = apply_icon_mapping(b, options, state_spec, nav_icon_size)
+
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/sizegrip.py

@@ -0,0 +1,15 @@
+"""Sizegrip widget style builders.
+
+This module contains style builders for ttk.Sizegrip and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TSizegrip')
+def build_sizegrip_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    b.configure_style(ttk_style, background=surface)

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 ttkbootstrap_icons_bs import BootstrapIcon
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+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,
+)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TSpinbox')
+def build_spinbox_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    fill_token = options.get('input_background') or 'content'
+    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 = BootstrapIcon('caret-up-fill', color=foreground, size=icon_size).image
+    arrow_up_disabled_img = BootstrapIcon('caret-up-fill', color=disabled_foreground, size=icon_size).image
+    arrow_down_normal_img = BootstrapIcon('caret-down-fill', color=foreground, size=icon_size).image
+    arrow_down_disabled_img = BootstrapIcon('caret-down-fill', color=disabled_foreground, size=icon_size).image
+
+    # 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,67 @@
+"""Switch widget style builders.
+
+This module contains style builders for switch (toggle) variants of ttk.Checkbutton.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import create_transparent_image, recolor_element_image
+
+
+@BootstyleBuilderTTk.register_builder('switch', 'TCheckbutton')
+def build_switch_style(b: BootstyleBuilderTTk, 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)
+    hovered = b.active(normal)
+    border = b.border(background)
+    focus = hovered
+    focus_ring = b.focus_ring(normal, background)
+
+    normal_checked_img = recolor_element_image('switch_on', background, normal, background)
+    normal_unchecked_img = recolor_element_image('switch_off', background, border, background)
+
+    focus_checked_img = recolor_element_image('switch_on', background, focus, focus_ring)
+    focus_unchecked_img = recolor_element_image('switch_off', background, border, focus_ring)
+
+    disabled_checked_img = recolor_element_image('switch_on', background, foreground_disabled, background)
+    disabled_unchecked_img = recolor_element_image('switch_off', foreground_disabled, foreground_disabled, 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
+                ('focus selected', focus_checked_img.image),
+                ('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, background=background, foreground=foreground, font="body")
+    b.map_style(ttk_style, background=[], foreground=[('disabled', foreground_disabled), ('', foreground)])