bootstack 0.1.0a1__py3-none-any.whl

bootstack/style/builders/notebook.py

@@ -0,0 +1,316 @@
+"""Notebook widget style builders.
+
+This module contains style builders for ttk.Notebook widget and variants.
+
+# TODO add styles in the future that are geared towards left direction navigation
+"""
+
+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 _client_border_image(surface: str, accent: str, show_border: bool):
+    border_accent = accent if show_border else surface
+    return recolor_element_image(
+        "notebook_client_border",
+        surface,
+        border_accent,
+        surface,
+        surface,
+    )
+
+
+def _border_image(surface: str, accent: str, border: str, show_border: bool):
+    border_accent = border if show_border else surface
+    return recolor_element_image(
+        "border",
+        accent,
+        border_accent,
+        surface,
+        surface,
+    )
+
+
+def _notebook_layout(ttk_style: str) -> Element:
+    return Element(f"{ttk_style}.Notebook.border").children(
+        [
+            Element(f"{ttk_style}.Tab", side="top", expand=True),
+            Element(f"{ttk_style}.Notebook.client", sticky="nsew"),
+        ]
+    )
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TNotebook')
+@BootstyleBuilderTTk.register_builder('tab', 'TNotebook')
+def build_tabs_notebook(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or "background"
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+    show_border = options.get('show_border', True)
+
+    # notebook colors
+    tab_active_color = surface
+    tab_accent_color = b.color(accent or 'background[+1]')
+    tab_accent_hover = b.active(tab_accent_color)
+
+    tab_active_foreground = b.on_color(surface)
+    tab_accent_foreground = b.on_color(tab_accent_color)
+    tab_disabled_foreground = b.disabled('text')
+    tab_active_border = b.border(surface)
+
+    # notebook border assets, style and layout
+    client_border_img = _client_border_image(surface, tab_accent_color, show_border)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.Notebook.client', client_border_img.image,
+            border=client_border_img.meta.border
+        )
+    )
+
+    tab_border_img = _border_image(surface, tab_accent_color, border_color, show_border)
+
+    b.create_style_element_image(
+        ElementImage(f"{ttk_style}.Notebook.border", tab_border_img.image, border=tab_border_img.meta.border)
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        _notebook_layout(ttk_style),
+    )
+
+    tab_active_img = recolor_element_image(
+        'notebook_tab_active', tab_active_color, tab_active_border)
+    tab_normal_img = recolor_element_image(
+        'notebook_tab_normal', tab_accent_color, tab_accent_color, tab_active_border, tab_accent_color)
+    tab_hover_img = recolor_element_image(
+        'notebook_tab_normal', tab_accent_hover, tab_accent_hover, tab_active_border, tab_accent_color)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.Notebook.tab', tab_normal_img.image,
+            sticky='nsew', padding=tab_normal_img.meta.border, border=tab_normal_img.meta.border,
+            height=b.scale(24)).state_specs(
+            [
+                ('selected', tab_active_img.image),
+                ('active', tab_hover_img.image),
+                ('', tab_normal_img.image),
+            ])
+    )
+
+    b.create_style_layout(
+        f"{ttk_style}.Tab",
+        Element(f"{ttk_style}.Notebook.tab").children(
+            [
+                Element("Notebook.padding", side="top").children(
+                    [
+                        Element("Notebook.label")
+                    ]
+                )
+            ]
+        )
+    )
+
+    b.configure_style(
+        f"{ttk_style}.Tab",
+        font="body",
+        foreground=tab_accent_foreground,
+        padding=b.scale((14, 0)))
+
+    b.map_style(
+        f"{ttk_style}.Tab",
+        foreground=[
+            ('disabled', tab_disabled_foreground),
+            ('selected !disabled', tab_active_foreground),
+            ('active !selected !disabled', tab_accent_foreground),
+            ('', tab_accent_foreground),
+        ]
+    )
+
+    # general notebook style
+    b.configure_style(ttk_style, padding=b.scale((3, 6, 3, 3)), tabmargins=(*b.scale([6, 4, 0]), -1))
+
+
+@BootstyleBuilderTTk.register_builder('pill', 'TNotebook')
+def build_pill_notebook(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or "background"
+    surface = b.color(surface_token)
+
+    # notebook pill colors
+    pill_active_color = b.color(accent or 'primary')
+    pill_active_border_color = b.border(pill_active_color)
+    pill_active_foreground = b.on_color(pill_active_color)
+    pill_normal_color = surface
+    pill_normal_foreground = b.on_color(pill_normal_color)
+    pill_disabled_foreground = b.disabled('text', surface)
+    pill_normal_hover = b.subtle(accent or 'primary', surface)
+
+    # notebook border assets & style
+    notebook_border = b.border(surface)
+    show_border = options.get('show_border', True)
+
+    notebook_border_img = _border_image(surface, surface, notebook_border, show_border)
+    b.create_style_element_image(
+        ElementImage(f'{ttk_style}.Notebook.border', notebook_border_img.image, border=notebook_border_img.meta.border)
+    )
+
+    # notebook border assets, style and layout
+    client_border_img = _client_border_image(surface, surface, False)
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.Notebook.client', client_border_img.image,
+            border=client_border_img.meta.border
+        )
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        _notebook_layout(ttk_style),
+    )
+
+    # notebook tab assets & style
+    pill_active_img = recolor_element_image(
+        'notebook_pill', pill_active_color, pill_active_border_color, surface, surface)
+    pill_normal_img = recolor_element_image(
+        'notebook_pill', pill_normal_color, pill_normal_color, surface, surface)
+    pill_normal_hover_img = recolor_element_image(
+        'notebook_pill', pill_normal_hover, pill_normal_hover, surface, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f'{ttk_style}.Notebook.tab', pill_normal_img.image,
+            sticky='nsew', padding=pill_normal_img.meta.border, border=pill_normal_img.meta.border,
+            height=b.scale(24)).state_specs(
+            [
+                ('selected', pill_active_img.image),
+                ('active !selected', pill_normal_hover_img.image),
+                ('', pill_normal_img.image),
+            ])
+    )
+
+    b.create_style_layout(
+        f'{ttk_style}.Tab',
+        Element(f'{ttk_style}.Notebook.tab', sticky="nsew").children(
+            [
+                Element('Notebook.padding', side='top').children(
+                    [
+                        Element('Notebook.label')
+                    ])
+            ])
+    )
+
+    b.configure_style(
+        f"{ttk_style}.Tab",
+        foreground=pill_normal_foreground,
+        font="body",
+        padding=b.scale((14, 0)))
+
+    b.map_style(
+        f"{ttk_style}.Tab",
+        foreground=[
+            ('disabled', pill_disabled_foreground),
+            ('selected !disabled', pill_active_foreground),
+            ('active !selected !disabled', pill_normal_foreground),
+            ('', pill_normal_foreground),
+        ]
+    )
+
+    b.configure_style(ttk_style, padding=b.scale(3), tabmargins=b.scale((6, 6, 0, 0)))
+
+
+@BootstyleBuilderTTk.register_builder('bar', 'TNotebook')
+def build_bar_notebook(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    surface_token = options.get('surface') or "background"
+    surface = b.color(surface_token)
+    border_color = b.border(surface)
+    show_border = options.get('show_border', True)
+
+    # notebook colors
+    accent_color = b.color(accent or 'primary')
+    foreground = b.on_color(surface)
+    disabled = b.disabled('text', surface)
+    hover = b.subtle(accent or 'primary', surface)
+
+    client_border_img = _client_border_image(surface, border_color, show_border)
+
+    b.create_style_element_image(
+        ElementImage(
+            f"{ttk_style}.Notebook.client",
+            client_border_img.image,
+            border=client_border_img.meta.border,
+        )
+    )
+
+    tab_border_img = _border_image(surface, surface, border_color, show_border)
+
+    b.create_style_element_image(
+        ElementImage(
+            f"{ttk_style}.Notebook.border",
+            tab_border_img.image,
+            border=tab_border_img.meta.border
+        )
+    )
+
+    b.create_style_layout(
+        ttk_style,
+        _notebook_layout(ttk_style),
+    )
+
+    active_img = recolor_element_image("notebook_tab_bar", surface, surface, accent_color, surface)
+    active_hover_img = recolor_element_image("notebook_tab_bar", hover, surface, accent_color, surface)
+    normal_img = recolor_element_image("notebook_tab_bar", surface, surface, surface, surface)
+    hover_img = recolor_element_image("notebook_tab_bar", hover, surface, hover, surface)
+
+    b.create_style_element_image(
+        ElementImage(
+            f"{ttk_style}.Notebook.tab", normal_img.image, sticky="nsew",
+            padding=normal_img.meta.border, border=normal_img.meta.border, height=b.scale(24)
+        ).state_specs(
+            [
+                ("selected !disabled", active_img.image),
+                ("active selected !disabled", active_hover_img.image),
+                ("active !selected !disabled", hover_img.image),
+                ("", normal_img.image),
+            ]
+        )
+    )
+
+    b.create_style_layout(
+        f"{ttk_style}.Tab",
+        Element(f"{ttk_style}.Notebook.tab").children(
+            [
+                Element("Notebook.padding", side="top").children(
+                    [
+                        Element("Notebook.label")
+                    ]
+                )
+            ]
+        )
+    )
+
+    b.configure_style(
+        f"{ttk_style}.Tab",
+        foreground=foreground,
+        font="body",
+        focuscolor="",
+        padding=b.scale((14, 0)),
+    )
+
+    b.map_style(
+        f"{ttk_style}.Tab",
+        foreground=[
+            ("disabled", disabled),
+            ("", foreground),
+        ],
+    )
+
+    # General notebook style (similar to Forest's: -padding 2 + margins)
+    b.configure_style(
+        ttk_style,
+        background=surface,
+        padding=b.scale(3),
+        tabmargins=b.scale((4, 6, 0, 0)),
+    )

bootstack/style/builders/panedwindow.py

@@ -0,0 +1,25 @@
+"""Panedwindow widget style builders.
+
+This module contains style builders for ttk.Panedwindow widget and variants.
+"""
+
+from __future__ import annotations
+
+from bootstack.style.bootstyle_builder_ttk import BootstyleBuilderTTk
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TPanedwindow')
+def build_paned_window_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = None, **options):
+    accent_token = accent or 'border'
+    surface_token = options.get('surface', 'content')
+    sash_thickness = options.get('sash_thickness', b.scale(6))
+
+    surface = b.color(surface_token)
+    if accent_token == 'border':
+        accent_color = b.border(surface)
+    else:
+        accent_color = b.color(accent_token)
+
+    # Sash thickness is a global adjustment that affects all paned windows
+    b.configure_style("Sash", sashthickness=sash_thickness, gripcount=0)
+    b.configure_style(ttk_style, background=accent_color)

bootstack/style/builders/progressbar.py

@@ -0,0 +1,71 @@
+"""Progressbar widget style builders.
+
+This module contains style builders for ttk.Progressbar 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 recolor_element_image
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TProgressbar')
+def build_default_progressbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    build_progressbar_style(b, ttk_style, accent, 'default', **options)
+
+
+@BootstyleBuilderTTk.register_builder('striped', 'TProgressbar')
+def build_striped_progressbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    build_progressbar_style(b, ttk_style, accent, 'striped', **options)
+
+
+@BootstyleBuilderTTk.register_builder('thin', 'TProgressbar')
+def build_thin_progressbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    build_progressbar_style(b, ttk_style, accent, 'thin', **options)
+
+def build_progressbar_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str, variant: str, **options):
+    orient = options.get("orient")
+    surface_token = options.get("surface", "content")
+
+    # style colors
+    background = b.color(surface_token)
+    trough_color = b.border(background)
+    trough_disabled = b.disabled("background")
+    bar_color = b.color(accent or "primary")
+    bar_disabled = b.disabled("text")
+
+    sticky = "ew" if orient == "horizontal" else "ns"
+    side = "left" if orient == "horizontal" else "top"
+
+    bar_image_key = f'progress_bar_{orient}_{variant}'
+    trough_image_key = bar_image_key if variant == 'thin' else f"progress_bar_{orient}_trough"
+
+    trough_normal_img = recolor_element_image(trough_image_key, trough_color, trough_color)
+    trough_disabled_img = recolor_element_image(trough_image_key, trough_disabled, trough_disabled)
+    bar_normal_img = recolor_element_image(bar_image_key, background, bar_color)
+    bar_disabled_img = recolor_element_image(bar_image_key, background, bar_disabled)
+    element_prefix = ttk_style.replace('TProgressbar', 'Progressbar')
+
+    b.create_style_element_image(
+        ElementImage(
+            f"{element_prefix}.trough", trough_normal_img.image, sticky='nsew').state_specs(
+            [
+                ('disabled', trough_disabled_img.image)
+            ]))
+
+    b.create_style_element_image(
+        ElementImage(f"{element_prefix}.pbar", bar_normal_img.image).state_specs(
+            [
+                ('disabled', bar_disabled_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style,
+        Element(f'{element_prefix}.trough', sticky="nsew").children(
+            [
+                Element(f'{element_prefix}.pbar', sticky=sticky, side=side)
+            ]))
+
+    b.configure_style(ttk_style, background=background)
+    b.map_style(ttk_style, background=[])

bootstack/style/builders/radiobutton.py

@@ -0,0 +1,68 @@
+"""Radio Button widget style builders.
+
+This module contains style builders for ttk.Radiobutton 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', 'TRadiobutton')
+def build_radiobutton_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)
+    hovered = b.active(normal)
+    border = b.border(background)
+    focus = hovered
+    focus_ring = b.focus_ring(normal, background)
+
+    normal_checked_img = recolor_element_image('radio_selected', background, normal, background)
+    normal_unchecked_img = recolor_element_image('radio_unselected', background, border, background)
+
+    focus_checked_img = recolor_element_image('radio_selected', background, focus, focus_ring)
+    focus_unchecked_img = recolor_element_image('radio_unselected', background_hover, focus, focus_ring)
+
+    disabled_checked_img = recolor_element_image('radio_selected', background, foreground_disabled, background)
+    disabled_unchecked_img = recolor_element_image('radio_unselected', background, 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", padding=b.scale(4)).state_specs(
+            [
+                # Disabled states
+                ('disabled selected', disabled_checked_img.image),
+                ('disabled !selected !alternate', disabled_unchecked_img.image),
+
+                # Focused states
+                ('focus selected', focus_checked_img.image),
+                ('focus !selected !alternate', focus_unchecked_img.image),
+
+                # Normal base states
+                ('selected', normal_checked_img.image),
+                ('!selected !alternate', normal_unchecked_img.image),
+            ]
+        ))
+
+    b.create_style_layout(
+        ttk_style, Element('Radiobutton.padding', sticky="nsew").children(
+            [
+                Element(f'{ttk_style}.indicator', side="left", sticky=""),
+                Element(f'{ttk_style}.spacer', side="left"),
+                Element('Radiobutton.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/scale.py

@@ -0,0 +1,66 @@
+"""Scale widget style builders.
+
+This module contains style builders for ttk.Scale 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
+
+
+@BootstyleBuilderTTk.register_builder('default', 'TScale')
+def build_scale_style(b: BootstyleBuilderTTk, ttk_style: str, accent: str = 'primary', **options):
+    accent_token = accent or 'primary'
+    surface_token = options.get('surface', 'content')
+    orient = options.get('orient', 'vertical').title()
+
+    background = b.color(surface_token)
+    foreground = b.on_color(background)
+    foreground_disabled = b.disabled("text")
+    track_color = b.border(background)
+    handle_normal = b.color(accent_token)
+    handle_pressed = b.pressed(handle_normal)
+    handle_disabled = b.disabled("text")
+    track_disabled = b.disabled("background")
+
+    # style images
+    handle_normal_img = recolor_element_image("slider_handle", background, handle_normal)
+    handle_pressed_img = recolor_element_image("slider_handle_focus", background, handle_normal)
+    handle_focus_img = recolor_element_image("slider_handle_focus", background, handle_pressed)
+    handle_disabled_img = recolor_element_image("slider_handle", handle_disabled, handle_disabled)
+
+    track_normal_img = recolor_element_image(f"slider_track_{orient.lower()}", track_color)
+    track_disabled_img = recolor_element_image(f"slider_track_{orient.lower()}", track_disabled)
+    sticky = "ew" if orient == "Horizontal" else "ns"
+    side = "left" if orient == "Horizontal" else "top"
+
+    b.create_style_element_image(
+        ElementImage(f"{ttk_style}.{orient}.Scale.slider", handle_normal_img.image,
+                     width=handle_normal_img.meta.height,
+                     height=handle_normal_img.meta.width,
+                     sticky=''
+                     ).state_specs(
+            [
+                ('disabled', handle_disabled_img.image),
+                ('background focus', handle_focus_img.image),
+                ('pressed', handle_pressed_img.image),
+            ]))
+
+    b.create_style_element_image(
+        ElementImage(f"{ttk_style}.{orient}.Scale.trough", track_normal_img.image,
+                     padding=track_normal_img.meta.padding,
+                     border=track_normal_img.meta.border).state_specs(
+            [
+                ('disabled', track_disabled_img.image)
+            ]))
+
+    b.create_style_layout(
+        ttk_style, Element(f"{orient}.Scale.padding", sticky=sticky).children(
+            [
+                Element(f'{ttk_style}.{orient}.Scale.trough', sticky=sticky),
+                Element(f'{ttk_style}.{orient}.Scale.slider', sticky="", side=side)]))
+
+    b.configure_style(ttk_style, background=background, foreground=foreground)
+    b.map_style(ttk_style, background=[], foreground=[('disabled', foreground_disabled), ('', foreground)])