bootstack 0.1.0__py3-none-any.whl

bootstack/style/builders/scrollbar.py

@@ -0,0 +1,225 @@
+"""Scrollbar style builders.
+
+This module contains style builders for ttk.Scrollbar widget variants.
+"""
+from typing import Optional
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.element import Element, ElementImage
+from bootstack.style.utility import recolor_element_image, create_box_image
+
+
+# A few-pixel thumb for the 'thin' variant — suits narrow lists/navs.
+_THIN_SCROLLBAR_THICKNESS = 4
+
+
+def build_horizontal_scrollbar(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    thumb_normal = b.color(accent) if accent is not None else border_color
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Horizontal.Scrollbar.trough', sticky="we").children([
+            Element(f'{ttk_style}.thumb', sticky="ew"),
+        ])
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=thumb_normal,
+        troughcolor=surface,
+        padding=0,
+        bordercolor=surface,
+        darkcolor=thumb_normal,
+        lightcolor=thumb_normal,
+        gripcount=0,
+        relief='flat',
+        arrowsize=0,
+    )
+    b.map_style(
+        ttk_style,
+        background=[('pressed', thumb_pressed), ('active', thumb_active)],
+        darkcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+        lightcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+    )
+
+
+def build_vertical_scrollbar(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    thumb_normal = b.color(accent) if accent is not None else border_color
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Vertical.Scrollbar.trough', sticky="ns").children([
+            Element(f'{ttk_style}.thumb', sticky="ns"),
+        ]),
+    )
+
+    b.configure_style(
+        ttk_style,
+        background=thumb_normal,
+        troughcolor=surface,
+        padding=0,
+        bordercolor=surface,
+        darkcolor=thumb_normal,
+        lightcolor=thumb_normal,
+        gripcount=0,
+        relief='flat',
+        arrowsize=0,
+    )
+    b.map_style(
+        ttk_style,
+        background=[('pressed', thumb_pressed), ('active', thumb_active)],
+        darkcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+        lightcolor=[('pressed', thumb_pressed), ('active', thumb_active)],
+    )
+
+
+@StyleBuilderTtk.register_builder('default', 'TScrollbar')
+def build_rounded_scrollbar_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    if options.get('orient', 'vertical') == 'vertical':
+        _build_rounded_vertical_scrollbar(b, ttk_style, accent, **options)
+    else:
+        _build_rounded_horizontal_scrollbar(b, ttk_style, accent, **options)
+
+
+@StyleBuilderTtk.register_builder('thin', 'TScrollbar')
+def build_thin_scrollbar_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    """A thin, square scrollbar — a few-pixel solid thumb on a surface-matched track.
+
+    Suited to narrow lists and navs. The thumb is neutral (the surface border
+    color) by default, or the accent when one is given; the track matches the
+    surface so an auto-hiding bar leaves no visible gutter tint. The thumb image
+    is a flat box generated on demand (it stretches uniformly along the track —
+    no rounding), so the bar reads as a clean square sliver.
+    """
+    orient = options.get('orient', 'vertical')
+    surface = b.color(options.get('surface', 'content'))
+    thumb = b.color(accent) if accent is not None else b.border(surface)
+    thumb_active = b.active(thumb)
+    thumb_pressed = b.pressed(thumb)
+    t = _THIN_SCROLLBAR_THICKNESS
+
+    if orient == 'vertical':
+        size = (t, 8)
+        trough_el = 'Vertical.Scrollbar.trough'
+        sticky = 'ns'
+    else:
+        size = (8, t)
+        trough_el = 'Horizontal.Scrollbar.trough'
+        sticky = 'ew'
+
+    normal_img = create_box_image(size[0], size[1], thumb)
+    active_img = create_box_image(size[0], size[1], thumb_active)
+    pressed_img = create_box_image(size[0], size[1], thumb_pressed)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.thumb', normal_img, border=0, width=size[0], height=size[1],
+        ).state_specs([
+            ('pressed', pressed_img),
+            ('active', active_img),
+            ('', normal_img),
+        ]))
+
+    b.create_style_layout(
+        ttk_style,
+        Element(trough_el, sticky=sticky).children([
+            Element(f'{ttk_style}.thumb', sticky=sticky),
+        ]))
+
+    b.configure_style(
+        ttk_style, troughcolor=surface, bordercolor=surface, relief='flat', arrowsize=0,
+    )
+
+
+def _build_rounded_vertical_scrollbar(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    thumb_normal = b.color(accent) if accent is not None else border_color
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    thumb_normal_img = recolor_element_image('scrollbar_vertical', thumb_normal, thumb_active, surface, surface)
+    thumb_active_img = recolor_element_image('scrollbar_vertical', thumb_active, thumb_active, surface, surface)
+    thumb_pressed_img = recolor_element_image('scrollbar_vertical', thumb_pressed, thumb_pressed, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.thumb', thumb_normal_img.image,
+            padding=thumb_normal_img.meta.border, border=thumb_normal_img.meta.border,
+            width=thumb_normal_img.meta.width, height=thumb_normal_img.meta.height).state_specs(
+            [
+                ('pressed', thumb_pressed_img.image),
+                ('active', thumb_active_img.image),
+                ('', thumb_normal_img.image),
+            ]),
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Vertical.Scrollbar.trough', sticky="ns").children([
+            Element(f'{ttk_style}.thumb', sticky="ns"),
+        ]),
+    )
+
+    b.configure_style(
+        ttk_style,
+        troughcolor=surface,
+        bordercolor=surface,
+        relief='flat',
+        arrowsize=0,
+    )
+
+
+def _build_rounded_horizontal_scrollbar(b: StyleBuilderTtk, ttk_style: str, accent: Optional[str] = None, **options):
+    surface_token = options.get('surface', 'content')
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+
+    thumb_normal = b.color(accent) if accent is not None else border_color
+    thumb_active = b.active(thumb_normal)
+    thumb_pressed = b.pressed(thumb_normal)
+
+    thumb_normal_img = recolor_element_image('scrollbar_horizontal', thumb_normal, thumb_active, surface, surface)
+    thumb_active_img = recolor_element_image('scrollbar_horizontal', thumb_active, thumb_active, surface, surface)
+    thumb_pressed_img = recolor_element_image('scrollbar_horizontal', thumb_pressed, thumb_pressed, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.thumb', thumb_normal_img.image,
+            padding=thumb_normal_img.meta.border, border=thumb_normal_img.meta.border,
+            width=thumb_normal_img.meta.width, height=thumb_normal_img.meta.height).state_specs(
+            [
+                ('pressed', thumb_pressed_img.image),
+                ('active', thumb_active_img.image),
+                ('', thumb_normal_img.image),
+            ]),
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        Element('Horizontal.Scrollbar.trough', sticky="we").children([
+            Element(f'{ttk_style}.thumb', sticky="ew"),
+        ])
+    )
+
+    b.configure_style(
+        ttk_style,
+        troughcolor=surface,
+        bordercolor=surface,
+        relief='flat',
+        arrowsize=0,
+    )

bootstack/style/builders/separator.py

@@ -0,0 +1,49 @@
+"""Separator widget style builders.
+
+This module contains style builders for ttk.Separator widgets and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.style_builder_ttk import StyleBuilderTtk
+from bootstack.style.element import ElementImage, Element
+from bootstack.style.utility import create_box_image
+
+
+@StyleBuilderTtk.register_builder('default', 'TSeparator')
+def build_separator_style(b: StyleBuilderTtk, ttk_style: str, accent: str = None, **options):
+    accent_token = accent or 'border'
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'horizontal')
+    thickness = options.get('thickness', 1)
+    length = options.get('length')  # None means stretch to fill
+
+    # Default length for the image (will stretch if packed with fill)
+    default_length = length or 40
+    width, height = (default_length, thickness)
+    if orient == 'vertical':
+        width, height = (thickness, default_length)
+
+    surface = b.color(surface_token)
+    if accent_token == 'border':
+        # `border_strength` (0..1) blends the stroke toward the surface's on-color;
+        # higher = closer to the surface = quieter line. Omitted = the b.border
+        # default. Lets callers (e.g. the shell dividers) soften the stroke.
+        strength = options.get('border_strength')
+        accent_color = b.border(surface) if strength is None else b.border(surface, strength)
+    else:
+        accent_color = b.color(accent_token)
+
+    img = create_box_image(width, height, accent_color)
+    sticky = "ew" if orient == "horizontal" else "ns"
+
+    # When length is specified, set explicit dimensions to prevent stretching
+    if length and orient == 'vertical':
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky, height=length))
+    elif length and orient == 'horizontal':
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky, width=length))
+    else:
+        b.create_style_element_image(ElementImage(f"{ttk_style}.Separator", img, border=0, sticky=sticky))
+
+    b.create_style_layout(ttk_style, Element(f"{ttk_style}.Separator", sticky=sticky))
+    b.configure_style(ttk_style, background=surface)