bootstack 0.1.0__py3-none-any.whl

bootstack/style/builders/calendar.py

@@ -0,0 +1,271 @@
+from __future__ import annotations
+
+from typing import Optional
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.builders.utils import toolbutton_layout, button_padding, button_font, apply_icon_mapping, icon_size
+from bootstack.style.element import ElementImage
+from bootstack.style.utility import recolor_element_image
+
+# Calendar uses 'compact' density for all styles
+CALENDAR_DENSITY = 'compact'
+
+
+@StyleBuilderTtk.register_builder('calendar-day', 'Toolbutton')
+def build_calendar_day_toolbutton_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the calendar day button style.
+
+    Style options include:
+        * icon_only
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    icon_only = options.get('icon_only', False)
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+    accent_color = b.color(accent_token)
+
+    active = b.active(accent_color)
+    on_accent = b.on_color(accent_color)
+
+    selected = b.selected(accent_color)
+
+    focus_ring = b.color('foreground')
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image('button_compact', surface, surface, surface, surface)
+    normal_focus_img = recolor_element_image('button_compact', surface, surface, focus_ring, surface)
+    active_img = recolor_element_image('button_compact', active, active, surface, surface)
+    selected_img = recolor_element_image('button_compact', selected, selected, surface, surface)
+    selected_focus_img = recolor_element_image('button_compact', selected, selected, focus_ring, surface)
+
+    disabled_img = recolor_element_image('button_compact', disabled, disabled, 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),
+                ('pressed', selected_img.image),
+                ('background focus selected', selected_focus_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('selected', selected_img.image),
+                ('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_surface,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, CALENDAR_DENSITY),
+        anchor="center",
+        font=button_font(CALENDAR_DENSITY)
+    )
+
+    state_spec = dict(
+        foreground=[
+            ('disabled', on_disabled),
+            ('pressed', on_accent),
+            ('selected', on_accent),
+            ('active', on_accent),
+            ('', on_surface)
+        ],
+    )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, CALENDAR_DENSITY))
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@StyleBuilderTtk.register_builder('calendar-range', 'Toolbutton')
+def build_calendar_range_toolbutton_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the calendar range button style.
+
+    Style options include:
+        * icon_only
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    icon_only = options.get('icon_only', False)
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+
+    accent_color = b.subtle(accent_token, surface)
+
+    surface_active = b.active(surface)
+    accent_focus = b.focus(accent_color)
+    on_accent = b.on_color(accent_color)
+
+    focus_ring = b.color('foreground')
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image('button_compact', surface, surface, surface, surface)
+    normal_focus_img = recolor_element_image('button_compact', surface, surface, focus_ring, surface)
+    active_img = recolor_element_image('button_compact', surface_active, surface_active, surface, surface)
+    selected_img = recolor_element_image('button_compact', accent_color, accent_color, accent_color, accent_color)
+    selected_focus_img = recolor_element_image('button_compact', accent_focus, accent_focus, focus_ring, accent_color)
+
+    disabled_img = recolor_element_image('button_compact', disabled, disabled, 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),
+                ('pressed', selected_img.image),
+                ('background focus selected', selected_focus_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('selected', selected_img.image),
+                ('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_surface,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, CALENDAR_DENSITY),
+        anchor="center",
+        font=button_font(CALENDAR_DENSITY)
+    )
+
+    state_spec = dict(
+        background=[('selected', accent_color)],
+        foreground=[
+            ('disabled', on_disabled),
+            ('pressed', on_accent),
+            ('selected', on_accent),
+            ('active', on_accent),
+            ('', on_surface)
+        ],
+    )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, CALENDAR_DENSITY))
+
+    b.map_style(ttk_style, **state_spec)
+
+
+@StyleBuilderTtk.register_builder('calendar-outside', 'Toolbutton')
+def build_calendar_outside_style(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    """
+    Configure style for outside/disabled calendar days.
+
+    Uses surface background and muted text to blend in with the calendar.
+    """
+    surface_token = options.get('surface', 'content')
+    icon_only = options.get('icon_only', False)
+    surface = b.color(surface_token)
+    on_disabled = b.disabled('text', surface)
+
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        foreground=on_disabled,
+        relief='flat',
+        padding=button_padding(b, icon_only, CALENDAR_DENSITY),
+        anchor="center",
+        font=button_font(CALENDAR_DENSITY)
+    )
+
+    # All states use surface background with muted text
+    b.map_style(ttk_style, background=[('', surface)], foreground=[('', on_disabled)])
+
+
+
+@StyleBuilderTtk.register_builder('calendar-date', 'Toolbutton')
+def build_calendar_date_toolbutton_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    """
+    Configure the calendar date button style.
+
+    Style options include:
+        * icon_only
+    """
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    icon_only = options.get('icon_only', False)
+
+    surface = b.color(surface_token)
+    on_surface = b.on_color(surface)
+
+    accent_color = b.color(accent_token)
+    accent_subtle = b.subtle(accent_token, surface)
+    accent_selected = b.selected(accent_color)
+
+    surface_active = b.active(surface)
+    on_accent = b.on_color(accent_color)
+
+    focus_ring = b.color('foreground')
+    disabled = b.disabled()
+    on_disabled = b.disabled('text', disabled)
+
+    normal_img = recolor_element_image('button_compact', surface, surface, surface, surface)
+    normal_focus_img = recolor_element_image('button_compact', surface, surface, focus_ring, surface)
+    active_img = recolor_element_image('button_compact', surface_active, surface_active, surface, surface)
+    selected_img = recolor_element_image('button_compact', accent_selected, accent_selected, accent_subtle, accent_subtle)
+    selected_focus_img = recolor_element_image('button_compact', accent_selected, accent_selected, focus_ring, accent_subtle)
+
+    disabled_img = recolor_element_image('button_compact', disabled, disabled, 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),
+                ('pressed', selected_img.image),
+                ('background focus selected', selected_focus_img.image),
+                ('selected', selected_img.image),
+                ('background focus !selected', normal_focus_img.image),
+                ('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_surface,
+        stipple="gray12",
+        relief='flat',
+        padding=button_padding(b, icon_only, CALENDAR_DENSITY),
+        anchor="center",
+        font=button_font(CALENDAR_DENSITY)
+    )
+
+    state_spec = dict(
+        background=[('selected', accent_subtle)],
+        foreground=[
+            ('disabled', on_disabled),
+            ('pressed', on_accent),
+            ('selected', on_accent),
+            ('', on_surface)
+        ],
+    )
+
+    state_spec = apply_icon_mapping(b, options, state_spec, icon_size(icon_only, CALENDAR_DENSITY))
+
+    b.map_style(ttk_style, **state_spec)

bootstack/style/builders/checkbutton.py

@@ -0,0 +1,110 @@
+"""Checkbutton widget style builders.
+
+This module contains style builders for ttk.Checkbutton widgets and variants.
+"""
+
+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, recolor_element_image
+from bootstack.style.builders.utils import resolve_icon_spec
+
+# Label-area custom state icons act as the state indicator, so they read a touch
+# larger than a text accent icon.
+_STATE_ICON_SIZE = 22
+
+
+@StyleBuilderTtk.register_builder('default', 'TCheckbutton')
+def build_checkbutton_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)
+    background_hover = b.active(background)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled('text', background)
+
+    normal = b.color(accent_token)
+    border = b.muted_foreground(background)
+    focus = b.focus(normal)
+    focus_ring = b.color('foreground')
+    disabled = b.disabled()
+
+    show_indicator = options.get('show_indicator', True)
+
+    if show_indicator:
+        spacer_img = create_transparent_image(6, 1)
+        b.create_style_element_image(ElementImage(f'{ttk_style}.spacer', spacer_img, sticky="ew"))
+
+        normal_checked_img = recolor_element_image('checkbox_checked', background, normal, background, background)
+        normal_unchecked_img = recolor_element_image('checkbox_unchecked', background, border, background, background)
+        normal_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, normal, background, background)
+
+        focus_checked_img = recolor_element_image('checkbox_checked', background, focus, focus_ring, background)
+        focus_unchecked_img = recolor_element_image('checkbox_unchecked', background_hover, focus, focus_ring, background)
+        focus_indeterminate_img = recolor_element_image('checkbox_indeterminate', background, focus, focus_ring, background)
+
+        disabled_checked_img = recolor_element_image(
+            'checkbox_checked', disabled, foreground_disabled, background, background)
+        disabled_unchecked_img = recolor_element_image(
+            'checkbox_unchecked', foreground_disabled, foreground_disabled, background, background)
+        disabled_indeterminate_img = recolor_element_image(
+            'checkbox_indeterminate', disabled, foreground_disabled, background, background)
+
+        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
+                    ('background focus alternate !selected', focus_indeterminate_img.image),
+                    ('background focus selected', focus_checked_img.image),
+                    ('background focus !selected !alternate', focus_unchecked_img.image),
+
+                    # Normal base states
+                    ('alternate !selected', normal_indeterminate_img.image),
+                    ('selected', normal_checked_img.image),
+                    ('!selected !alternate', normal_unchecked_img.image),
+                ]
+            ))
+
+    # Label-area icon: stateful, independent of show_indicator.
+    # Accent color when selected, foreground when unselected.
+    icon_images = []
+    icon_spec_raw = resolve_icon_spec(options)
+    if icon_spec_raw is not None:
+        icon_spec = b.normalize_icon_spec(icon_spec_raw, _STATE_ICON_SIZE)
+        fg_spec = [
+            ('disabled', foreground_disabled),
+            ('selected !disabled', normal),
+            ('', border),
+        ]
+        icon_images = b.map_stateful_icons(icon_spec, fg_spec)
+
+    layout_children = []
+    if show_indicator:
+        layout_children += [
+            Element(f'{ttk_style}.indicator', side="left", sticky=""),
+            Element(f'{ttk_style}.spacer', side="left"),
+        ]
+    layout_children.append(Element('Checkbutton.label', side="left", sticky="nsew"))
+
+    b.create_style_layout(
+        ttk_style, Element('Checkbutton.padding', sticky="nsew").children(layout_children)
+    )
+
+    b.configure_style(ttk_style, background=background, foreground=foreground, font="body")
+
+    map_kwargs = {
+        'background': [],
+        'foreground': [('disabled', foreground_disabled), ('', foreground)],
+    }
+    if icon_images:
+        map_kwargs['image'] = icon_images
+        if not options.get('icon_only', False):
+            map_kwargs['compound'] = 'left'
+    b.map_style(ttk_style, **map_kwargs)

bootstack/style/builders/combobox.py

@@ -0,0 +1,113 @@
+"""Combobox widget style builders.
+
+This module contains style builders for ttk.Combobox 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,
+    button_height,
+    entry_font,
+    entry_padding,
+    entry_icon_size,
+    entry_image_key,
+    chevron_width,
+)
+
+
+@StyleBuilderTtk.register_builder('default', 'TCombobox')
+def build_combobox_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, height=button_height(b, density)).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 = _ImageService.get_icon('caret-down-fill', icon_size, foreground)
+    chevron_disabled_img = _ImageService.get_icon('caret-down-fill', icon_size, disabled_foreground)
+
+    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)],
+    )