bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/checkbutton.py

@@ -0,0 +1,95 @@
+"""Checkbutton widget style builders.
+
+This module contains style builders for ttk.Checkbutton widgets and variants.
+"""
+
+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('default', 'TCheckbutton')
+def build_checkbutton_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)
+    background_hover = b.active(background)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled('text', background)
+
+    normal = b.color(accent_token)
+    pressed = b.pressed(normal)
+    hovered = b.active(normal)
+    border = b.border(background)
+    focus = hovered
+    focus_ring = b.focus_ring(normal, background)
+    disabled = b.disabled()
+
+    normal_checked_img = recolor_element_image('checkbox_checked', background, normal, background)
+    normal_unchecked_img = recolor_element_image('checkbox_unchecked', background, border, background)
+    normal_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, normal, background)
+
+    hovered_checked_img = recolor_element_image('checkbox_checked', background, hovered, background)
+    hovered_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, border, background)
+    hovered_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, hovered, background)
+
+    pressed_checked_img = recolor_element_image('checkbox_checked', background, pressed, background)
+    pressed_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, pressed, background)
+    pressed_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, pressed, background)
+
+    focus_checked_img = recolor_element_image('checkbox_checked', background, focus, focus_ring)
+    focus_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, focus, focus_ring)
+    focus_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, focus, focus_ring)
+
+    disabled_checked_img = recolor_element_image('checkbox_checked', disabled, foreground_disabled, background)
+    disabled_unchecked_img = recolor_element_image(
+        'checkbox_unchecked', foreground_disabled, foreground_disabled, background)
+    disabled_indeterminate_img = recolor_element_image('checkbox_indeterminate', 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 alternate !selected', disabled_indeterminate_img.image),
+                ('disabled selected', disabled_checked_img.image),
+                ('disabled !selected !alternate', disabled_unchecked_img.image),
+
+                # Focused states
+                ('focus alternate !selected', focus_indeterminate_img.image),
+                ('focus selected', focus_checked_img.image),
+                ('focus !selected !alternate', focus_unchecked_img.image),
+
+                # Pressed states
+                ('pressed alternate !selected', pressed_indeterminate_img.image),
+                ('pressed selected', pressed_checked_img.image),
+                ('pressed !selected !alternate', pressed_unchecked_img.image),
+
+                # Hover states
+                ('hover alternate !selected', hovered_indeterminate_img.image),
+                ('hover selected', hovered_checked_img.image),
+                ('hover !selected !alternate', hovered_unchecked_img.image),
+
+                # Normal base states
+                ('alternate !selected', normal_indeterminate_img.image),
+                ('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)])

bootstack/style/builders/combobox.py

@@ -0,0 +1,112 @@
+"""Combobox widget style builders.
+
+This module contains style builders for ttk.Combobox 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,
+    chevron_width,
+)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TCombobox')
+def build_combobox_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 chevron image - use density-aware icon size
+    icon_size = entry_icon_size(b, density)
+    chevron_normal_img = BootstrapIcon('caret-down-fill', color=foreground, size=icon_size).image
+    chevron_disabled_img = BootstrapIcon('caret-down-fill', color=disabled_foreground, size=icon_size).image
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.chevron', chevron_normal_img, sticky='', border=1, width=chevron_width(b)).state_specs(
+            [
+                ('disabled', chevron_disabled_img),
+                ('', chevron_normal_img),
+            ])
+    )
+
+    # layout
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.field', sticky="ew").children(
+            [
+                Element(f'{ttk_style}.chevron', side='right', sticky='s'),
+                Element('Combobox.padding', sticky="nsew", expand=1).children(
+                    [
+                        Element("Combobox.textarea", sticky="nsew")
+                    ])
+            ])
+    )
+
+    # postoffset aligns the popdown with the inner edge of the visible input
+    # border, accounting for both the focus-ring affordance and the border
+    # line baked into the input image (10 source-px for default, 8 source-px
+    # for compact). Tk's PlacePopdown reads {dx dy dw dh} and adjusts the
+    # popdown geometry accordingly.
+    inset = b.scale_from_source(8 if density == 'compact' else 10)
+    postoffset = (inset, 0, -2 * inset, 0)
+
+    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),
+        postoffset=postoffset,
+    )
+
+    b.map_style(
+        ttk_style,
+        selectforeground=[],
+        selectbackground=[],
+        foreground=[('disabled !readonly', disabled_foreground), ('', foreground)],
+    )

bootstack/style/builders/contextmenu.py

@@ -0,0 +1,268 @@
+from __future__ import annotations
+
+from ttkbootstrap_icons_bs import BootstrapIcon
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.builders.utils import apply_icon_mapping, button_font, normalize_button_density
+from bootstack.style.element import Element
+from bootstack.style.utility import create_transparent_image
+
+
+def _context_item_layout(ttk_style: str) -> Element:
+    """Layout for context menu items - simple background with padding and label."""
+    return Element(f"{ttk_style}.border", sticky="nsew").children(
+        [
+            Element("Toolbutton.padding", sticky="nsew").children(
+                [
+                    Element("Toolbutton.label", sticky="nsew")
+                ])
+        ])
+
+
+@BootstyleBuilderTTk.register_builder('context-check', 'Toolbutton')
+def build_context_check_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    density = normalize_button_density(options.get('density', 'default'))
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+    on_disabled = b.disabled('text', surface)
+
+    active = b.active(surface)
+    pressed = b.pressed(surface)
+    on_pressed = b.on_color(pressed)
+
+    b.create_style_layout(
+        ttk_style,
+        _context_item_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        stipple='gray12',
+        padding=(6, 3),
+        anchor='w',
+        font=button_font(density),
+        compound='left',
+        focuscolor=''
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('focus !disabled', on_pressed),
+            ('pressed', on_pressed),
+            ('', on_surface)],
+        background=[
+            ('focus !disabled', active),
+            ('pressed !disabled', pressed),
+            ('active !disabled', active),
+            ('', surface)
+        ]
+    )
+
+    icon_empty = create_transparent_image(16, 16)
+    icon_pressed = BootstrapIcon('check', 16, on_pressed)
+    icon_normal = BootstrapIcon('check', 16, on_surface)
+
+    state_spec['image'] = [
+        ('selected pressed', icon_pressed),
+        ('selected', icon_normal),
+        ('', icon_empty)
+    ]
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('context-radio', 'Toolbutton')
+def build_context_radio_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface', 'content')
+    density = normalize_button_density(options.get('density', 'default'))
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+    on_disabled = b.disabled('text', surface)
+
+    active = b.active(surface)
+    pressed = b.pressed(surface)
+    on_pressed = b.on_color(pressed)
+
+    b.create_style_layout(
+        ttk_style,
+        _context_item_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        stipple='gray12',
+        padding=(6, 3),
+        anchor='w',
+        font=button_font(density),
+        compound='left',
+        focuscolor=''
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('focus !disabled', on_pressed),
+            ('pressed', on_pressed),
+            ('', on_surface)],
+        background=[
+            ('focus !disabled', active),
+            ('pressed !disabled', pressed),
+            ('active !disabled', active),
+            ('', surface)
+        ]
+    )
+
+    icon_empty = create_transparent_image(16, 16)
+    icon_pressed = BootstrapIcon('check', 16, on_pressed)
+    icon_normal = BootstrapIcon('check', 16, on_surface)
+
+    state_spec['image'] = [
+        ('selected pressed', icon_pressed),
+        ('selected', icon_normal),
+        ('', icon_empty)
+    ]
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('context-frame', 'TFrame')
+def build_context_frame_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the context menu frame style for composite items.
+
+    Provides hover/active background states matching context-item.
+    """
+    surface_token = options.get('surface', 'content')
+
+    surface = b.color(surface_token)
+    active = b.active(surface)
+    pressed = b.pressed(surface)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        relief='flat',
+    )
+
+    b.map_style(
+        ttk_style,
+        background=[
+            ('focus !disabled', active),
+            ('pressed !disabled', pressed),
+            ('hover !disabled', active),
+            ('', surface)
+        ]
+    )
+
+
+@BootstyleBuilderTTk.register_builder('context-label', 'TLabel')
+def build_context_label_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the context menu label style for shortcut text.
+
+    Uses muted foreground color and matches context-item state behavior.
+    """
+    surface_token = options.get('surface', 'content')
+    density = normalize_button_density(options.get('density', 'default'))
+
+    surface = b.color(surface_token)
+    muted = b.color('secondary')
+    on_disabled = b.disabled('text', surface)
+
+    active = b.active(surface)
+    pressed = b.pressed(surface)
+    on_pressed = b.on_color(pressed)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=muted,
+        relief='flat',
+        anchor='e',
+        font=button_font(density),
+    )
+
+    b.map_style(
+        ttk_style,
+        foreground=[
+            ('disabled', on_disabled),
+            ('focus !disabled', muted),
+            ('pressed', muted),
+            ('hover !disabled', muted),
+            ('', muted)
+        ],
+        background=[
+            ('focus !disabled', active),
+            ('pressed !disabled', pressed),
+            ('hover !disabled', active),
+            ('', surface)
+        ]
+    )
+
+
+@BootstyleBuilderTTk.register_builder('context-item', 'TButton')
+def build_context_item_button_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the context menu button style.
+
+    Style options include:
+        * icon
+        * icon_only
+        * anchor
+        * density
+    """
+    anchor = options.get('anchor', 'w')
+    surface_token = options.get('surface', 'content')
+    density = normalize_button_density(options.get('density', 'default'))
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+    on_disabled = b.disabled('text', surface)
+
+    active = b.active(surface)
+    pressed = b.pressed(surface)
+    on_pressed = b.on_color(pressed)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_surface,
+        relief='flat',
+        stipple='gray12',
+        padding=(6, 3),
+        anchor=anchor,
+        font=button_font(density),
+        focuscolor=''
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('focus !disabled', on_pressed),
+            ('pressed', on_pressed),
+            ('hover !disabled', on_pressed),
+            ('', on_surface)],
+        background=[
+            ('focus !disabled', active),
+            ('pressed !disabled', pressed),
+            ('hover !disabled', active),
+            ('active !disabled', active),
+            ('', surface)
+        ]
+    )
+
+    icon_only = options.get('icon_only', False)
+    default_size = 20 if icon_only else 16
+    state_spec = apply_icon_mapping(b, options, state_spec, default_size)
+
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/entry.py

@@ -0,0 +1,83 @@
+"""Entry widget style builders.
+
+This module contains style builders for ttk.Entry widget and variants.
+"""
+
+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 (
+    normalize_button_density,
+    entry_font,
+    entry_padding,
+    entry_image_key,
+)
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TEntry')
+def build_entry_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)
+            ]
+        )
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{ttk_style}.field', sticky='nsew').children(
+            [
+                Element('Entry.padding', sticky='nsew').children(
+                    [
+                        Element('Entry.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
+    )
+
+    b.map_style(
+        ttk_style,
+        selectforeground=[],
+        selectbackground=[],
+        foreground=[('disabled !readonly', disabled_foreground), ('', foreground)],
+    )