bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/expander.py

@@ -0,0 +1,171 @@
+"""Style builders for the Expander widget."""
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.builders.utils import apply_icon_mapping
+
+
+@BootstyleBuilderTTk.register_builder('solid', 'Expander.TFrame')
+def build_solid_expander_header_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    background = b.color(accent or 'primary')
+    active = b.active(background)
+    pressed = b.pressed(background)
+    focus_border = b.focus_border(active)
+    selected = b.selected(active)
+
+    b.configure_style(ttk_style, background=background, borderwidth=1, relief='raised')
+
+    b.map_style(
+        ttk_style,
+        background=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', active),
+            ('', background)
+        ],
+        darkcolor=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', active),
+            ('', background)
+        ],
+        lightcolor=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', active),
+            ('', background)
+        ],
+        bordercolor=[
+            ('background focus', focus_border),
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', active),
+            ('', background)
+        ]
+    )
+
+
+@BootstyleBuilderTTk.register_builder('solid', 'Expander.TLabel')
+def build_solid_expander_header_label_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Expander header label style with state-aware foreground."""
+    background = b.color(accent or 'primary')
+    active = b.active(background)
+    pressed = b.pressed(background)
+    selected = b.selected(active)
+
+    on_background = b.on_color(background)
+    on_active = b.on_color(active)
+    on_pressed = b.on_color(pressed)
+    disabled = b.disabled('text', background)
+
+    b.configure_style(
+        ttk_style,
+        background=background,
+        foreground=on_background,
+        relief='flat',
+        font='body'
+    )
+
+    foreground_state_map = [
+        ('disabled', disabled),
+        ('pressed', on_pressed),
+        ('hover', on_active),
+        ('', on_background)
+    ]
+
+    background_state_map = [
+        ('selected', selected),
+        ('pressed', pressed),
+        ('hover', active),
+        ('', background)
+    ]
+
+    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('default', 'Expander.TFrame')
+def build_ghost_expander_header_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    accent_token = accent or 'foreground'
+    surface_token = options.get('surface', 'content')
+
+    surface = b.color(surface_token)
+    accent_color = b.color(accent_token)
+
+    hovered = pressed = b.subtle(accent_token, surface)
+    selected = b.selected(hovered)
+
+    focused_border = b.focus_border(accent_color) if accent_token != 'foreground' else b.focus_border(b.color('primary'))
+
+    b.configure_style(ttk_style, background=surface, borderwidth=1, relief='raised')
+    b.map_style(
+        ttk_style,
+        background=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', hovered),
+            ('', surface)
+        ],
+        darkcolor=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', hovered),
+            ('', surface)
+        ],
+        lightcolor=[
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', hovered),
+            ('', surface)
+        ],
+        bordercolor=[
+            ('background focus', focused_border),
+            ('selected', selected),
+            ('pressed', pressed),
+            ('hover', hovered),
+            ('', surface)
+        ]
+    )
+
+
+@BootstyleBuilderTTk.register_builder('default', 'Expander.TLabel')
+def build_ghost_expander_header_label_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """Expander header label style with state-aware foreground."""
+    accent_token = accent or 'foreground'
+    surface_token = options.get('surface', 'content')
+
+    surface = b.color(surface_token)
+    accent_color = b.color(accent_token)
+
+    hovered = pressed = b.subtle(accent_token, surface)
+    selected = b.selected(hovered)
+
+    on_surface = accent_color
+    on_disabled = b.disabled('text', accent_color)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        font='body'
+    )
+
+    foreground_state_map = [
+        ('disabled', on_disabled),
+        ('', on_surface)
+    ]
+
+    background_state_map = [
+        ('selected', selected),
+        ('disabled', surface),
+        ('pressed', pressed),
+        ('hover', hovered),
+        ('', 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)

bootstack/style/builders/field.py

@@ -0,0 +1,312 @@
+"""Field widget style builders.
+
+This module contains style builders for ttk.Frame widget and field variants used to build
+the Entry containers.
+"""
+
+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,
+    field_height,
+    entry_icon_size,
+    entry_image_key,
+    spinner_arrow_height,
+    spinner_arrow_width,
+)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TField')
+def build_field_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')
+    normal = fill
+    border = b.border(fill)
+    disabled = b.disabled('text')
+    focused_border = b.focus_border(accent_color)
+    focused_ring = b.focus_ring(accent_color, container_surface)
+
+    # input element images - 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, normal, disabled, container_surface, container_surface)
+
+    # input element
+    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),
+                ('focus', focused_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=fill)
+
+
+@BootstyleBuilderTTk.register_builder('input', 'TField')
+def build_field_input_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)
+    disabled_bg = b.disabled('background')
+    disabled_fg = b.disabled('text')
+    foreground = b.on_color(fill)
+
+    # Inner field is a white fill that gets recolored; height controls density
+    field_img = recolor_element_image('field', fill)
+    height = field_height(b, density)
+
+    b.create_style_element_image(ElementImage(f'{ttk_style}.field', field_img.image, sticky="nsew", height=height))
+    b.create_style_layout(
+        ttk_style, Element(f'{ttk_style}.field').children(
+            [
+                Element('Entry.padding', sticky="ew").children(
+                    [
+                        Element('Entry.textarea', sticky="nsew")
+                    ])
+            ]))
+
+    b.configure_style(
+        ttk_style,
+        relief='flat',
+        foreground=foreground,
+        background=fill,
+        fieldbackground=fill,
+        selectborderwidth=0,
+        bordercolor=fill,
+        darkcolor=fill,
+        lightcolor=fill,
+        insertcolor=foreground,
+        padding=entry_padding(b, density),
+        font=entry_font(density),
+        selectforeground=b.on_color(b.color('primary')),
+        selectbackground=b.color('primary')
+    )
+
+    b.map_style(
+        ttk_style,
+        background=[('disabled', disabled_bg), ('readonly', disabled_bg)],
+        fieldbackground=[('disabled', disabled_bg)],
+        selectforeground=[],
+        selectbackground=[],
+        bordercolor=[('disabled', disabled_bg)],
+        darkcolor=[('disabled', disabled_bg)],
+        lightcolor=[('disabled', disabled_bg)],
+        foreground=[('disabled !readonly', disabled_fg), ('', foreground)],
+    )
+
+
+@BootstyleBuilderTTk.register_builder('spinner', 'TField')
+def build_spinner_input_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)
+    disabled_bg = b.disabled('background')
+    disabled_fg = b.disabled('text')
+    foreground = b.on_color(fill)
+
+    # Inner field is a white fill that gets recolored; height controls density
+    field_img = recolor_element_image('field', fill)
+    height = field_height(b, density)
+
+    b.create_style_element_image(ElementImage(f'{ttk_style}.field', field_img.image, sticky="nsew", height=height))
+
+    # add arrow images - use density-aware icon size
+    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_fg, 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_fg, 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'),
+                    ])
+            ]),
+    )
+
+    # Add extra right padding for spinner arrows
+    base_padding = entry_padding(b, density)
+    spinner_padding = (base_padding[0], base_padding[1], base_padding[0] + b.scale(3), base_padding[1])
+
+    b.configure_style(
+        ttk_style,
+        relief='flat',
+        foreground=foreground,
+        background=fill,
+        fieldbackground=fill,
+        selectborderwidth=0,
+        bordercolor=fill,
+        darkcolor=fill,
+        lightcolor=fill,
+        insertcolor=foreground,
+        padding=spinner_padding,
+        font=entry_font(density),
+        selectforeground=b.on_color(b.color('primary')),
+        selectbackground=b.color('primary')
+    )
+
+    b.map_style(
+        ttk_style,
+        background=[('disabled', disabled_bg), ('readonly', disabled_bg)],
+        fieldbackground=[('disabled', disabled_bg)],
+        selectforeground=[],
+        selectbackground=[],
+        bordercolor=[('disabled', disabled_bg)],
+        darkcolor=[('disabled', disabled_bg)],
+        lightcolor=[('disabled', disabled_bg)],
+        foreground=[('disabled !readonly', disabled_fg), ('', foreground)],
+    )
+
+
+@BootstyleBuilderTTk.register_builder('prefix', 'TField')
+def build_field_prefix_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    build_field_addon_style(b, ttk_style, accent, 'before', **options)
+
+
+@BootstyleBuilderTTk.register_builder('suffix', 'TField')
+def build_field_suffix_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    build_field_addon_style(b, ttk_style, accent, 'after', **options)
+
+
+def build_field_addon_style(b: BootstyleBuilderTTk, ttk_style: str, _: str, variant: str, **options):
+    """Build prefix/suffix addon styles for entry fields.
+
+    Args:
+        b: The bootstyle builder instance.
+        ttk_style: The TTK style name.
+        _: Unused accent parameter.
+        variant: 'before' for prefix, 'after' for suffix.
+        **options: Style options including 'density', 'surface', 'use_active_states', 'icon'.
+    """
+    surface_token = options.get('surface', 'content')
+    fill_token = options.get('input_background') or 'content'
+    density = normalize_button_density(options.get('density', 'default'))
+    use_active_states = options.get('use_active_states', False)
+    fill = b.color(fill_token)
+
+    if use_active_states:
+        surface_active = b.active(fill)
+        surface_pressed = b.pressed(fill)
+    else:
+        surface_active = surface_pressed = fill
+
+    border = b.border(fill)
+    foreground = b.on_color(fill)
+    foreground_disabled = b.disabled('text')
+    normal = b.disabled(surface=fill)
+
+    # addon element images - use density-aware images from manifest
+    # variant is 'before' or 'after', maps to input_before_* or input_after_*
+    img_key = entry_image_key(f'input_{variant}', density)
+    normal_img = recolor_element_image(img_key, normal, border)
+
+    if use_active_states:
+        active_img = recolor_element_image(img_key, surface_active, border)
+        pressed_img = recolor_element_image(img_key, surface_pressed, border)
+    else:
+        active_img = pressed_img = normal_img
+
+    # addon element - set explicit height to match field height
+    height = field_height(b, density)
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.border', normal_img.image, border=normal_img.meta.border, height=height).state_specs([
+            ('pressed', pressed_img.image),
+            ('active', active_img.image),
+            ('', normal_img.image)
+        ]))
+
+    b.create_style_layout(
+        ttk_style, Element(f"{ttk_style}.border", sticky="nsew").children(
+            [
+                Element("Button.padding", sticky="nsew").children(
+                    [
+                        Element("Button.label", sticky="nsew")
+                    ])
+            ]))
+
+    # Add horizontal padding - less for icon-only buttons
+    icon_only = options.get('icon_only', False)
+    if icon_only:
+        addon_padding = b.scale((5, 0)) if density == 'compact' else b.scale((4, 0))
+    else:
+        addon_padding = b.scale((8, 0))
+    b.configure_style(
+        ttk_style,
+        background=fill,
+        foreground=foreground,
+        relief='flat',
+        stipple="gray12",
+        padding=addon_padding,
+        anchor='center',
+    )
+
+    # map icon if available
+    icon = options.get('icon')
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', foreground_disabled),
+            ('pressed !disabled', foreground),
+            ('hover !disabled', foreground),
+            ('', foreground)
+        ])
+
+    if icon is not None:
+        icon = b.normalize_icon_spec(icon)
+        # Use density-aware icon size for addon icons
+        addon_icon_size = b.scale(16) if density == 'compact' else b.scale(17)
+        icon['size'] = addon_icon_size
+        state_spec['image'] = b.map_stateful_icons(icon, state_spec['foreground'])
+
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/frame.py

@@ -0,0 +1,27 @@
+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
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TFrame')
+def build_frame(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or 'background'
+    show_border = options.get('show_border', False)
+    surface = b.color(surface_token)
+    stroke = b.border(surface)
+
+    if show_border:
+        border_img = recolor_element_image('border', surface, stroke, surface, surface)
+        b.create_style_element_image(
+            ElementImage(
+                f'{ttk_style}.border',
+                border_img.image,
+                border=border_img.meta.border,
+                padding=border_img.meta.border,
+                sticky="nsew")
+        )
+        b.create_style_layout(ttk_style, Element(f'{ttk_style}.border', sticky="nsew", border=border_img.meta.border))
+
+    b.configure_style(ttk_style, background=surface)

bootstack/style/builders/label.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TLabel')
+def build_label(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    background = b.color(surface_token)
+    if accent is None:
+        # best foreground on inherited background
+        foreground = b.on_color(background)
+    else:
+        # override
+        foreground = b.color(accent)
+
+    b.configure_style(ttk_style, background=background, foreground=foreground, font="body")
+
+    state_spec = dict(foreground=[('', foreground)])
+
+    # map icon if available
+    icon = options.get('icon')
+
+    if icon is not None:
+        icon = b.normalize_icon_spec(icon)
+        state_spec['image'] = b.map_stateful_icons(icon, state_spec['foreground'])
+
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/labelframe.py

@@ -0,0 +1,41 @@
+"""Labelframe widget style builders.
+
+This module contains style builders for ttk.Labelframe widget and variants.
+
+The Labelframe color is different than the normal frame in that the background color of the
+labelframe is inherited only unless overridden explicitly by the surface option. The
+bootstyle color is only relevant for the border color of the labelframe.
+"""
+
+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
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TLabelframe')
+def build_labelframe_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or 'background'
+    show_border = options.get('show_border', True)
+    surface = b.color(surface_token)
+
+    border = b.border(surface)
+    foreground = b.on_color(surface)
+
+    # border assets and styles
+    if show_border:
+        border_img = recolor_element_image('border', surface, border, surface)
+    else:
+        border_img = recolor_element_image('border', surface, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.border',
+            border_img.image,
+            border=border_img.meta.border,
+            sticky="nsew")
+    )
+    b.create_style_layout(ttk_style, Element(f'{ttk_style}.border', sticky="nsew"))
+    b.configure_style(f'{ttk_style}.Label', background=surface, foreground=foreground, font="label")
+    b.configure_style(ttk_style, background=surface)