fh-matui 0.9.5__tar.gz → 0.9.13__tar.gz

{fh_matui-0.9.5/fh_matui.egg-info → fh_matui-0.9.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fh-matui
-Version: 0.9.5
+Version: 0.9.13
 Summary: material-ui for fasthtml
 Home-page: https://github.com/abhisheksreesaila/fh-matui
 Author: abhishek sreesaila

fh_matui-0.9.13/fh_matui/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.9.12"

{fh_matui-0.9.5 → fh_matui-0.9.13}/fh_matui/_modidx.py

@@ -157,7 +157,10 @@ d = { 'settings': { 'branch': 'master',
                                                                                              'fh_matui/datatable.py'),
                                     'fh_matui.datatable.DataTableResource._wrap_modal': ( 'datatable.html#datatableresource._wrap_modal',
                                                                                           'fh_matui/datatable.py'),
+                                    'fh_matui.datatable.DataTableResource._wrap_response': ( 'datatable.html#datatableresource._wrap_response',
+                                                                                             'fh_matui/datatable.py'),
                                     'fh_matui.datatable._action_menu': ('datatable.html#_action_menu', 'fh_matui/datatable.py'),
+                                    'fh_matui.datatable._is_htmx_request': ('datatable.html#_is_htmx_request', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._page_size_select': ('datatable.html#_page_size_select', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._safe_int': ('datatable.html#_safe_int', 'fh_matui/datatable.py'),
                                     'fh_matui.datatable._to_dict': ('datatable.html#_to_dict', 'fh_matui/datatable.py'),

{fh_matui-0.9.5 → fh_matui-0.9.13}/fh_matui/components.py

@@ -4,7 +4,7 @@
 
 # %% auto 0
 __all__ = ['BUTTON_SPECIALS', 'ButtonT', 'ANCHOR_SPECIALS', 'AT', 'NavToggleButton', 'SpaceT', 'GridSpanT', 'GridCell', 'Grid',
-           'DivLAligned', 'DivVStacked', 'DivHStacked', 'DivRAligned', 'DivCentered', 'DivFullySpaced', 'Icon',
+           'DivHStacked', 'DivLAligned', 'DivVStacked', 'DivRAligned', 'DivCentered', 'DivFullySpaced', 'Icon',
            'NavBar', 'Modal', 'ModalButton', 'ModalCancel', 'ModalConfirm', 'ModalTitle', 'ModalBody', 'ModalFooter',
            'Field', 'LabelInput', 'FormLabel', 'CheckboxX', 'Radio', 'Switch', 'TextArea', 'Range', 'Select',
            'FormGrid', 'Progress', 'LoadingIndicator', 'Table', 'Td', 'Th', 'Thead', 'Tbody', 'Tfoot', 'TableFromLists',
@@ -29,9 +29,13 @@ from nbdev.showdoc import show_doc
 # %% ../nbs/02_components.ipynb 6
 #| code-fold: true
 def NavToggleButton(target, icon='menu', **kwargs):
-    """Create a navigation toggle button that toggles the 'max' class on the target element"""
+    """Create a navigation toggle button that toggles the 'max' class on the target element.
+    
+    Also toggles icon between 'menu' and 'menu_open' based on nav state.
+    """
     cls = kwargs.get('cls', 'circle transparent')
-    onclick = f"toggleNav('{target}'); return false;"
+    # Inline JS: toggle nav's max class AND change this button's icon
+    onclick = f"var nav=document.querySelector('{target}');if(nav){{nav.classList.toggle('max');var i=this.querySelector('i');if(i)i.textContent=nav.classList.contains('max')?'menu_open':'menu'}};return false;"
     kwargs.update({'onclick': onclick, 'cls': cls})
     return Button(I(icon), **kwargs)
 
@@ -225,19 +229,8 @@ def Grid(*cells, space=SpaceT.medium_space,
     return Div(*wrapped_cells, cls=stringify(dedupe_preserve_order(grid_cls)), **kwargs)
 
 # %% ../nbs/02_components.ipynb 16
-def DivLAligned(*c, cls='', **kwargs):
-    """MonsterUI-compatible left-aligned row using BeerCSS tokens."""
-    cls_tokens = normalize_tokens(cls)
-    tokens = ['left-align']
-    tokens.extend(cls_tokens)
-    tokens = [t for t in tokens if t]
-    return DivHStacked(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
-
-
-
-# %% ../nbs/02_components.ipynb 18
-def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
-    """Responsive vertical stack with padding and mobile compatibility."""
+def DivHStacked(*c, responsive=True, padding=True, cls='', **kwargs):
+    """Responsive horizontal stack with padding and mobile compatibility."""
     cls_tokens = normalize_tokens(cls)
     tokens = []
     if responsive and 'responsive' not in cls_tokens:
@@ -245,7 +238,7 @@ def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     if padding and 'padding' not in cls_tokens and 'no-padding' not in cls_tokens:
         tokens.append('padding')
     if 'grid' not in cls_tokens:
-        tokens.extend(['row', 'vertical'])
+        tokens.extend(['row', 'middle-align'])
     if not _has_space_token(cls_tokens):
         tokens.append(SpaceT.medium_space)
     tokens.extend(cls_tokens)
@@ -253,9 +246,20 @@ def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     return Div(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
 
-# %% ../nbs/02_components.ipynb 20
-def DivHStacked(*c, responsive=True, padding=True, cls='', **kwargs):
-    """Responsive horizontal stack with padding and mobile compatibility."""
+# %% ../nbs/02_components.ipynb 17
+def DivLAligned(*c, cls='', **kwargs):
+    """MonsterUI-compatible left-aligned row using BeerCSS tokens."""
+    cls_tokens = normalize_tokens(cls)
+    tokens = ['left-align']
+    tokens.extend(cls_tokens)
+    tokens = [t for t in tokens if t]
+    return DivHStacked(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
+
+
+
+# %% ../nbs/02_components.ipynb 19
+def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
+    """Responsive vertical stack with padding and mobile compatibility."""
     cls_tokens = normalize_tokens(cls)
     tokens = []
     if responsive and 'responsive' not in cls_tokens:
@@ -263,7 +267,7 @@ def DivHStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     if padding and 'padding' not in cls_tokens and 'no-padding' not in cls_tokens:
         tokens.append('padding')
     if 'grid' not in cls_tokens:
-        tokens.extend(['row', 'middle-align'])
+        tokens.extend(['row', 'vertical'])
     if not _has_space_token(cls_tokens):
         tokens.append(SpaceT.medium_space)
     tokens.extend(cls_tokens)
@@ -323,17 +327,58 @@ def Icon(icon: str, size: str = None, fill: bool = False, cls = (), **kwargs):
 
 # %% ../nbs/02_components.ipynb 32
 #| code-fold: true
-def NavBar(*children, brand=None, sticky=False, cls='', **kwargs):
-    """Horizontal navigation bar with optional brand and sticky positioning"""
-    nav_cls = f"{'sticky top' if sticky else ''} surface-container {cls}".strip()
+def NavBar(*children, brand=None, sticky=False, cls='', size='small',
+           hx_boost=True, hx_target='#main-content', **kwargs):
+    """Horizontal navigation bar with HTMX SPA navigation defaults.
+    
+    Args:
+        brand: Brand element (logo/title) positioned on the left
+        sticky: Whether navbar sticks to top on scroll
+        size: Navbar size - 'small' (default), 'medium', 'large', or None
+        hx_boost: Auto-enhance all <a> links for HTMX navigation (default True)
+        hx_target: Target element for boosted links (default '#main-content')
+    """
+    size_cls = size if size else ''
+    nav_cls = f"{'sticky top' if sticky else ''} surface-container {size_cls} {cls}".strip()
+    
+    # HTMX SPA optimizations
+    if hx_boost: kwargs['hx_boost'] = 'true'
+    if hx_target: kwargs['hx_target'] = hx_target
+    kwargs.setdefault('hx_push_url', 'true')
+    
+    # Use small-padding for compact navbar
+    padding_cls = 'small-padding' if size == 'small' else 'padding'
+    
     if brand:
-        return Nav(brand, Div(cls='max'), *children, cls=f"row middle-align padding {nav_cls}", **kwargs)
-    return Nav(*children, cls=f"padding {nav_cls}", **kwargs)
+        return Nav(brand, Div(cls='max'), *children, cls=f"row middle-align {padding_cls} {nav_cls}", **kwargs)
+    return Nav(*children, cls=f"{padding_cls} {nav_cls}", **kwargs)
 
 # %% ../nbs/02_components.ipynb 35
-def Modal(*c, id=None, footer=None, active=False, overlay=True, cls=(), **kwargs):
-    """BeerCSS modal dialog with optional overlay and footer."""
+def Modal(*c, id=None, footer=None, active=False, overlay='default', position=None, cls=(), **kwargs):
+    """BeerCSS modal dialog with position and overlay options.
+    
+    Always returns a list for consistent unpacking with *Modal(...).
+    When overlay is enabled, clicking the overlay closes the modal.
+    
+    Args:
+        *c: Modal content (title, body, etc.)
+        id: Modal ID for data-ui targeting
+        footer: Footer content (auto-wrapped in Nav if not already)
+        active: Whether modal starts active/visible
+        overlay: Overlay style - 'default' (plain), 'blur', 'small-blur', 
+                 'medium-blur', 'large-blur', or False/None (no overlay)
+        position: Position - None (center), 'left', 'right', 'top', 'bottom'
+        cls: Additional CSS classes
+    
+    Returns:
+        List of elements (overlay + dialog, or just [dialog] if no overlay)
+    """
     modal_cls = normalize_tokens(cls)
+    
+    # Add position class if specified
+    if position in ['left', 'right', 'top', 'bottom']:
+        modal_cls.append(position)
+    
     if active: 
         modal_cls.append('active')
     
@@ -349,19 +394,32 @@ def Modal(*c, id=None, footer=None, active=False, overlay=True, cls=(), **kwargs
     # Create the dialog
     dialog = Dialog(*children, id=id, cls=cls_str, **kwargs)
     
-    if overlay:
-        # Return overlay + dialog as separate elements that BeerCSS can manage
-        overlay_cls = "overlay blur"
+    # Handle overlay - always return a list for consistent *Modal(...) unpacking
+    if overlay and overlay not in [False, None]:
+        overlay_classes = ['overlay']
+        
+        # Map overlay parameter to BeerCSS classes
+        if overlay == 'blur':
+            overlay_classes.append('blur')
+        elif overlay == 'small-blur':
+            overlay_classes.append('small-blur')
+        elif overlay == 'medium-blur':
+            overlay_classes.append('medium-blur')
+        elif overlay == 'large-blur':
+            overlay_classes.append('large-blur')
+        # 'default' means plain overlay with no blur class
+        
+        overlay_cls = ' '.join(overlay_classes)
         if active:
             overlay_cls += " active"
-            
-        # Return as a list - both elements need to be at same DOM level
-        return [
-            Div(cls=overlay_cls),
-            dialog
-        ]
+        
+        # Overlay with data-ui to close modal on click (click-outside-to-close)
+        overlay_el = Div(cls=overlay_cls, data_ui=f"#{id}" if id else None)
+        
+        return [overlay_el, dialog]
     
-    return dialog
+    # No overlay - still return as list for consistent unpacking
+    return [dialog]
 
 def ModalButton(text: str, id: str, icon: str = None, cls=(), **kwargs):
     """Button that opens a modal via data-ui attribute."""
@@ -717,15 +775,14 @@ def Toolbar(*items, cls='', elevate='large', fill=True, **kwargs):
     if cls: classes.append(cls)
     return Nav(*items, cls=' '.join(classes), **kwargs)
 
-# %% ../nbs/02_components.ipynb 92
+# %% ../nbs/02_components.ipynb 93
 #| code-fold: true
-def Toast(*c, cls='', position='top', variant='', action=None, dur=5.0, active=False, **kwargs):
-    """BeerCSS snackbar/toast notification with position and variant options."""
+def Toast(*c, cls='', position='top', variant='', action=None, active=False, dur=None, **kwargs):
+    """BeerCSS snackbar/toast notification with position ('top' or 'bottom') and variant options."""
     classes = ['snackbar']
     if variant: classes.append(variant)
-    if position:
-        position_map = {'top': 'bottom', 'bottom': 'top', 'left': 'right', 'right': 'left'}
-        classes.append(position_map.get(position, position))
+    if position in ['top', 'bottom']:
+        classes.append(position)
     if active: classes.append('active')
     if cls: classes.append(cls)
     
@@ -735,13 +792,34 @@ def Toast(*c, cls='', position='top', variant='', action=None, dur=5.0, active=F
         if isinstance(action, str): content.append(A(action, cls='inverse-link'))
         else: content.append(action)
     else: content.extend(c)
-    return Div(*content, cls=' '.join(classes), **kwargs)
+    
+    snackbar = Div(*content, cls=' '.join(classes), **kwargs)
+    
+    # If duration is specified and there's an id, generate auto-hide script
+    if dur and 'id' in kwargs:
+        timeout_ms = int(dur * 1000)
+        toast_id = kwargs['id']
+        # Wait for Beer CSS module to load before calling ui()
+        script = Script(f"""
+window.addEventListener('load', function() {{
+    function showToast() {{
+        if (typeof ui !== 'undefined') {{
+            try {{ ui('#{toast_id}', {timeout_ms}); }}
+            catch (e) {{ console.error('Toast error:', e.message); }}
+        }}
+    }}
+    setTimeout(showToast, 50);
+}});
+""")
+        return (snackbar, script)
+    
+    return snackbar
 
 def Snackbar(*c, **kwargs):
     """Alias for Toast component."""
     return Toast(*c, **kwargs)
 
-# %% ../nbs/02_components.ipynb 94
+# %% ../nbs/02_components.ipynb 96
 #| code-fold: true
 class ContainerT(VEnum):
     """Container size options (BeerCSS). Most alias to 'responsive'; use 'expand' for full-width."""
@@ -752,7 +830,7 @@ class ContainerT(VEnum):
     xl = 'responsive'
     expand = 'responsive max'
 
-# %% ../nbs/02_components.ipynb 96
+# %% ../nbs/02_components.ipynb 98
 #| code-fold: true
 def _get_form_config(col: dict) -> dict:
     """Extract form config from column, with sensible defaults."""
@@ -828,7 +906,7 @@ def FormField(
             **attrs
         )
 
-# %% ../nbs/02_components.ipynb 98
+# %% ../nbs/02_components.ipynb 100
 #| code-fold: true
 from typing import Callable, Any
 
@@ -947,7 +1025,7 @@ def FormModal(
         cls="large-width"
     )
 
-# %% ../nbs/02_components.ipynb 100
+# %% ../nbs/02_components.ipynb 102
 #| code-fold: true
 def NavContainer(*li, title=None, brand=None, position='left', close_button=True, cls='active', id=None, **kwargs):
     """Slide-out navigation drawer with header and close button."""
@@ -1004,7 +1082,7 @@ def BottomNav(*c, cls='bottom', size='s', **kwargs):
     final_cls = f"{cls} {size_cls}".strip()
     return Nav(*c, cls=final_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 103
+# %% ../nbs/02_components.ipynb 105
 #| code-fold: true
 def NavSideBarHeader(*c, cls='', **kwargs):
     """Sidebar header section for menu buttons and branding."""
@@ -1017,33 +1095,76 @@ def NavSideBarLinks(*children, as_list=False, cls='', **kwargs):
         return Ul(*children, cls=list_cls, **kwargs)
     return Group(*children) if len(children) > 1 else (children[0] if children else Group())
 
-def NavSideBarContainer(*children, position='left', size='m', cls='', active=False, **kwargs):
-    """BeerCSS navigation sidebar/drawer component."""
+def NavSideBarContainer(*children, position='left', size='m', cls='', active=False,
+                        hx_boost=True, hx_target='#main-content', **kwargs):
+    """BeerCSS navigation sidebar with HTMX SPA navigation defaults.
+    
+    Args:
+        position: Sidebar position ('left' or 'right')
+        size: Sidebar size ('s', 'm', 'l')
+        active: Whether sidebar starts visible
+        hx_boost: Auto-enhance all <a> links for HTMX navigation (default True)
+        hx_target: Target element for boosted links (default '#main-content')
+    
+    Usage:
+        Routes should check `req.headers` for HX-Request and return content only for HTMX requests:
+        
+        @rt("/dashboard")
+        def dashboard(req):
+            content = dashboard_content()
+            if 'HX-Request' in req.headers: return content  # HTMX swap
+            return Layout(content)  # Full page load
+    """
     base_cls = f"{size} {position} surface-container"
     if active: base_cls += " active"
     nav_cls = f"{base_cls} {cls}".strip()
+    
+    # HTMX SPA optimizations
+    if hx_boost: kwargs['hx_boost'] = 'true'
+    if hx_target: kwargs['hx_target'] = hx_target
+    kwargs.setdefault('hx_push_url', 'true')
+    
     return Nav(*children, cls=nav_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 105
+# %% ../nbs/02_components.ipynb 107
 #| code-fold: true
 def Layout(*content, sidebar=None, sidebar_links=None, nav_bar=None, container_size=ContainerT.expand,
-           main_bg='surface', sidebar_id='app-sidebar', cls='', **kwargs):
-    """App layout wrapper with auto-toggle sidebar and sensible defaults."""
-    main_content = []
-    
-    if nav_bar:
-        if hasattr(nav_bar, 'attrs') and 'cls' in nav_bar.attrs:
-            if 'sticky' not in nav_bar.attrs['cls']: nav_bar.attrs['cls'] += ' sticky top'
-        main_content.append(nav_bar)
+           main_bg='surface', sidebar_id='app-sidebar', main_id='main-content', cls='', **kwargs):
+    """App layout with HTMX SPA navigation.
     
+    Args:
+        main_id: ID for main content area (default 'main-content') - use as hx-target
+        
+    HTMX SPA features:
+        - hx-boost on sidebar automatically enhances all <a> links
+        - hx-history-elt for back/forward button caching
+        - Routes should check `req.headers` for HX-Request and return content only for HTMX requests
+        
+    Usage:
+        @rt("/dashboard")
+        def dashboard(req):
+            content = dashboard_content()
+            if 'HX-Request' in req.headers: return content  # HTMX swap
+            return Layout(content)  # Full page load
+    """
+    # Build content wrapper with history caching
+    content_wrapper = None
     if content:
-        container_cls = stringify((container_size, 'padding', main_bg))
-        main_content.append(Main(*content, cls=container_cls))
+        content_wrapper = Div(*content, id=main_id, hx_history_elt='true')
     
+    # No sidebar - simple layout
     if not sidebar and not sidebar_links:
-        if main_content: return Div(*main_content, cls=cls, **kwargs)
-        else: return Div(cls=cls, **kwargs)
-    
+        result = []
+        if nav_bar:
+            if hasattr(nav_bar, 'attrs') and 'cls' in nav_bar.attrs:
+                if 'sticky' not in nav_bar.attrs['cls']: nav_bar.attrs['cls'] += ' sticky top'
+            result.append(nav_bar)
+        if content_wrapper:
+            container_cls = stringify((container_size, 'padding', main_bg))
+            result.append(Main(content_wrapper, cls=container_cls))
+        return Div(*result, cls=cls, **kwargs) if result else Div(cls=cls, **kwargs)
+    
+    # Sidebar layout with hx-boost
     sidebar_children = [NavSideBarHeader(NavToggleButton(f"#{sidebar_id}"))]
     
     if sidebar_links: sidebar_children.extend(sidebar_links)
@@ -1053,23 +1174,23 @@ def Layout(*content, sidebar=None, sidebar_links=None, nav_bar=None, container_s
     
     nav_rail = NavSideBarContainer(*sidebar_children, position='left', size='l', id=sidebar_id)
     
-    navbar_elem = None
-    content_items = []
-    for item in main_content:
-        if hasattr(item, 'tag') and item.tag == 'nav': navbar_elem = item
-        else: content_items.append(item)
-    
     layout_children = []
-    if navbar_elem: layout_children.append(navbar_elem)
+    
+    if nav_bar:
+        if hasattr(nav_bar, 'attrs') and 'cls' in nav_bar.attrs:
+            if 'sticky' not in nav_bar.attrs['cls']: nav_bar.attrs['cls'] += ' sticky top'
+        layout_children.append(nav_bar)
+    
     layout_children.append(nav_rail)
-    if content_items:
+    
+    if content_wrapper:
         container_cls = stringify((container_size, 'round', 'elevate', 'margin'))
-        layout_children.append(Main(*content_items, cls=container_cls))
+        layout_children.append(Main(content_wrapper, cls=container_cls))
     
     final_cls = f"surface-container {cls}".strip() if cls else "surface-container"
     return Div(*layout_children, cls=final_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 109
+# %% ../nbs/02_components.ipynb 113
 #| code-fold: true
 class TextT(VEnum):
     """Text styles using BeerCSS typography classes."""
@@ -1101,7 +1222,7 @@ class TextPresets(VEnum):
     primary_link = 'link primary-text'
     muted_link = 'link secondary-text'
 
-# %% ../nbs/02_components.ipynb 110
+# %% ../nbs/02_components.ipynb 114
 #| code-fold: true
 def CodeSpan(*c, cls=(), **kwargs):
     """Inline code snippet."""
@@ -1157,7 +1278,7 @@ def Sup(*c, cls=(), **kwargs):
     cls_str = stringify(cls) if cls else None
     return fc.Sup(*c, cls=cls_str, **kwargs) if cls_str else fc.Sup(*c, **kwargs)
 
-# %% ../nbs/02_components.ipynb 112
+# %% ../nbs/02_components.ipynb 116
 #| code-fold: true
 def FAQItem(question: str, answer: str, question_cls: str = '', answer_cls: str = ''):
     """Collapsible FAQ item using details/summary.
@@ -1175,7 +1296,7 @@ def FAQItem(question: str, answer: str, question_cls: str = '', answer_cls: str
         Summary(Article(Nav(Div(question, cls=f"max bold {question_cls}".strip()), I("expand_more")), cls="round surface-variant border no-elevate")),
         Article(P(answer, cls=f"secondary-text {answer_cls}".strip()), cls="round border padding"))
 
-# %% ../nbs/02_components.ipynb 116
+# %% ../nbs/02_components.ipynb 120
 #| code-fold: true
 def CookiesBanner(message='We use cookies to enhance your experience. By continuing to visit this site you agree to our use of cookies.',
                   accept_text='Accept', decline_text='Decline', settings_text=None, policy_link='/cookies', policy_text='Learn more',

{fh_matui-0.9.5 → fh_matui-0.9.13}/fh_matui/core.py

@@ -31,7 +31,7 @@ beer_hdrs = (
     Script(src=HEADER_URLS["mdc_js"], type='module'),
 )
 
-# %% ../nbs/01_core.ipynb 8
+# %% ../nbs/01_core.ipynb 7
 #| code-fold: true
 # All BeerCSS color names
 COLOR_NAMES = ['amber', 'blue', 'blue_grey', 'brown', 'cyan', 'deep_orange', 'deep_purple', 
@@ -88,7 +88,7 @@ ALL_HELPERS = (SIZES + WIDTH_HEIGHT + ELEVATES + DIRECTIONS + FORMS + MARGINS +
                POSITIONS + RESPONSIVE + ALIGNMENTS + BLURS + OPACITIES + SHADOWS + SPACES + 
                RIPPLES + SCROLLS + WAVES + ZOOMS + THEME_HELPERS + TYPOGRAPHY + TRIGGERS + COLOR_HELPERS)
 
-# %% ../nbs/01_core.ipynb 11
+# %% ../nbs/01_core.ipynb 10
 #| code-fold: true
 class _ThemeChain:
     """Internal class for building themed headers"""
@@ -142,14 +142,19 @@ class _ThemeChain:
                 }};
                 window.toggleNav = function(selector) {{
                     const nav = document.querySelector(selector);
-                    if (nav) {{ nav.classList.toggle('max'); }}
+                    if (nav) {{
+                        nav.classList.toggle('max');
+                        const isOpen = nav.classList.contains('max');
+                        const btn = nav.querySelector('button i, button .icon');
+                        if (btn) btn.textContent = isOpen ? 'menu_open' : 'menu';
+                    }}
                 }};
             ''')
             hdrs.append(theme_script)
         hdrs.append(Title(title))
         return tuple(hdrs)
 
-# %% ../nbs/01_core.ipynb 12
+# %% ../nbs/01_core.ipynb 11
 #| code-fold: true
 class _ThemeNamespace:
     """Namespace providing color properties that return _ThemeChain instances"""
@@ -208,7 +213,7 @@ class _ThemeNamespace:
 
 MatTheme = _ThemeNamespace()
 
-# %% ../nbs/01_core.ipynb 16
+# %% ../nbs/01_core.ipynb 15
 #| code-fold: true
 class BeerCssChain:
     """Base class for chaining Beer CSS helper classes together"""