bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/tabitem.py

@@ -0,0 +1,205 @@
+"""TabItem widget style builders.
+
+This module contains style builders for the TabItem composite widget.
+"""
+
+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
+
+
+def _apply_icon_mapping(b: BootstyleBuilderTTk, 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
+
+
+@BootstyleBuilderTTk.register_builder('bar', 'TabItem.TFrame')
+@BootstyleBuilderTTk.register_builder('default', 'TabItem.TFrame')
+def build_tab_item_bar_frame(b: BootstyleBuilderTTk, ttk_style: str, accent: 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'tabs_bar_{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, surface, accent_color)
+    selected_hover_img = recolor_element_image(image_key, accent_subtle, accent_subtle, 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')
+
+
+@BootstyleBuilderTTk.register_builder('bar', 'TabItem.TLabel')
+@BootstyleBuilderTTk.register_builder('default', 'TabItem.TLabel')
+def build_tab_item_bar_label(b: BootstyleBuilderTTk, ttk_style: str, accent: 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, b.scale(18))
+    b.map_style(ttk_style, **state_spec)
+
+
+# --- TabItem.TButton builders (for close button) ---
+
+def _build_tab_item_button_layout(b: BootstyleBuilderTTk, 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')
+            ])
+        ])
+    )
+
+
+@BootstyleBuilderTTk.register_builder('bar', 'TabItem.TButton')
+@BootstyleBuilderTTk.register_builder('default', 'TabItem.TButton')
+def build_tab_item_bar_button(b: BootstyleBuilderTTk, ttk_style: str, accent: 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, b.scale(12))
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('icon', 'TabItem.TButton')
+def build_tab_item_icon_button(b: BootstyleBuilderTTk, ttk_style: str, accent: 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, b.scale(12))
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/toolbutton.py

@@ -0,0 +1,260 @@
+"""Toolbutton widget style builders.
+
+This module contains style builders for ttk.Checkbutton and Radiobutton toolbutton variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import ElementImage
+from bootstack.style.utility import recolor_element_image
+from bootstack.style.builders.utils import (
+    apply_icon_mapping,
+    button_font,
+    button_padding,
+    icon_size,
+    normalize_button_density,
+    toolbutton_layout,
+)
+
+
+# The active styles are intentionally limited on toolbuttons to improve interaction
+# and limit the number of images created for each style.
+
+
+@BootstyleBuilderTTk.register_builder('default', 'Toolbutton')
+@BootstyleBuilderTTk.register_builder('solid', 'Toolbutton')
+def build_solid_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the button style.
+
+    Style options include:
+        * anchor
+        * icon
+        * icon_only
+        * density
+    """
+    anchor = options.get('anchor', 'center')
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    image_key = f'button_{normalize_button_density(density)}'
+
+    surface = b.color(surface_token)
+
+    accent_color = b.color(accent_token)
+
+    active = b.active(accent_color)
+    accent_focus = b.focus(accent_color)
+    on_accent = b.on_color(accent_color)
+
+    selected = b.selected(accent_color)
+
+    focus_ring = b.focus_ring(accent_focus, surface)
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image(image_key, accent_color, accent_color, surface, surface)
+    normal_focus_img = recolor_element_image(image_key, accent_color, accent_color, focus_ring, surface)
+    active_img = recolor_element_image(image_key, active, active, surface, surface)
+    selected_img = recolor_element_image(image_key, selected, selected, surface, surface)
+    selected_focus_img = recolor_element_image(image_key, selected, selected, focus_ring, 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),
+                ('background pressed focus selected', selected_focus_img.image),
+                ('pressed', selected_img.image),
+                ('background focus selected', selected_focus_img.image),
+                ('selected', selected_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('background active !focus', active_img.image),
+                ('', normal_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style,
+        toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_accent,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor=anchor,
+        font=button_font(density)
+    )
+
+    state_spec = dict(foreground=[('disabled', on_disabled), ('', on_accent)])
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('outline', 'Toolbutton')
+def build_outline_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the button style.
+
+    Style options include:
+        * anchor
+        * icon
+        * icon_only
+        * density
+    """
+    anchor = options.get('anchor', 'center')
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    image_key = f'button_{normalize_button_density(density)}'
+
+    surface = b.color(surface_token)
+    accent_color = b.color(accent_token)
+    accent_focus = b.focus(accent_color)
+    on_accent = b.on_color(accent_color)
+
+    focus_ring = b.focus_ring(accent_focus, surface)
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image(image_key, surface, accent_color, surface, surface)
+    normal_focus_img = recolor_element_image(image_key, surface, accent_focus, focus_ring, surface)
+    selected_img = recolor_element_image(image_key, accent_color, accent_color, surface, surface)
+    selected_focus_img = recolor_element_image(image_key, accent_color, accent_focus, focus_ring, 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),
+                ('background pressed selected focus', selected_focus_img.image),
+                ('pressed', selected_img.image),
+                ('background selected focus', selected_focus_img.image),
+                ('selected', selected_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('', normal_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style,
+        toolbutton_layout(ttk_style),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=accent_color,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, density),
+        anchor=anchor,
+        font=button_font(density)
+    )
+
+    state_spec = dict(
+        foreground=[('disabled', on_disabled), ('selected !disabled', on_accent), ('pressed !disabled', on_accent),
+                    ('', accent_color)],
+    )
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, density))
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@BootstyleBuilderTTk.register_builder('ghost', 'Toolbutton')
+def build_ghost_toolbutton_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the button style.
+
+    Style options include:
+        * anchor
+        * icon
+        * icon_only
+        * density
+    """
+    anchor = options.get('anchor', 'center')
+    accent_token = accent or 'secondary'
+    surface_token = options.get('surface', 'content')
+    density = options.get('density', 'default')
+    icon_only = options.get('icon_only', False)
+    image_key = f'button_{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)
+    on_surface = b.color('foreground')
+
+    active = b.subtle(accent_token, surface)
+    accent_color = b.color(accent_token)
+    accent_pressed = b.pressed(active)
+    accent_focus = b.focus(active)
+
+    focus_ring = b.focus_ring(accent_focus, surface)
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image(image_key, surface, surface, surface, surface)
+    normal_focus_img = recolor_element_image(image_key, surface, accent_color, focus_ring, surface)
+    hover_img = recolor_element_image(image_key, surface_hover, surface_hover, surface, surface)
+    selected_img = recolor_element_image(image_key, active, active, surface, surface)
+    selected_pressed_img = recolor_element_image(image_key, accent_pressed, accent_pressed, surface, surface)
+    selected_focus_img = recolor_element_image(image_key, accent_focus, accent_color, focus_ring, 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),
+                ('background pressed selected focus', selected_focus_img.image),
+                ('pressed', selected_img.image),
+                ('background selected focus', selected_focus_img.image),
+                ('selected pressed', selected_pressed_img.image),
+                ('selected', selected_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('hover !selected', 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,
+        stipple="gray12",
+        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),
+            ('pressed', 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)

bootstack/style/builders/tooltip.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+from bootstack.style.element import Element
+
+
+@BootstyleBuilderTTk.register_builder('tooltip', 'TFrame')
+def build_tooltip_frame(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or accent or "background"
+    if accent:
+        background = b.color(accent)
+    else:
+        background = b.color(surface_token)
+
+    border_color = b.border(background)
+
+    b.create_style_layout(ttk_style, Element(f'{ttk_style}.Frame.border', sticky="nsew"))
+
+    b.configure_style(
+        ttk_style,
+        background=background,
+        border_color=border_color,
+        darkcolor=background,
+        lightcolor=background,
+        relief='flat',
+        )