fh-matui 0.9.1__py3-none-any.whl → 0.9.3__py3-none-any.whl

fh_matui/__init__.py

@@ -1 +1 @@
-__version__ = "0.9"
+__version__ = "0.9.3"

fh_matui/_modidx.py

@@ -128,35 +128,35 @@ d = { 'settings': { 'branch': 'master',
                                'fh_matui.core._ThemeNamespace.violet': ('core.html#_themenamespace.violet', 'fh_matui/core.py'),
                                'fh_matui.core._ThemeNamespace.yellow': ('core.html#_themenamespace.yellow', 'fh_matui/core.py'),
                                'fh_matui.core._ThemeNamespace.zinc': ('core.html#_themenamespace.zinc', 'fh_matui/core.py')},
-            'fh_matui.datatable': { 'fh_matui.datatable.DataTable': ('table.html#datatable', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource': ('table.html#datatableresource', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource.__init__': ( 'table.html#datatableresource.__init__',
+            'fh_matui.datatable': { 'fh_matui.datatable.DataTable': ('datatable.html#datatable', 'fh_matui/datatable.py'),
+                                    'fh_matui.datatable.DataTableResource': ('datatable.html#datatableresource', 'fh_matui/datatable.py'),
+                                    'fh_matui.datatable.DataTableResource.__init__': ( 'datatable.html#datatableresource.__init__',
                                                                                        'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._error_toast': ( 'table.html#datatableresource._error_toast',
+                                    'fh_matui.datatable.DataTableResource._error_toast': ( 'datatable.html#datatableresource._error_toast',
                                                                                            'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._filter_by_search': ( 'table.html#datatableresource._filter_by_search',
+                                    'fh_matui.datatable.DataTableResource._filter_by_search': ( 'datatable.html#datatableresource._filter_by_search',
                                                                                                 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._get_filtered_data': ( 'table.html#datatableresource._get_filtered_data',
+                                    'fh_matui.datatable.DataTableResource._get_filtered_data': ( 'datatable.html#datatableresource._get_filtered_data',
                                                                                                  'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._handle_action': ( 'table.html#datatableresource._handle_action',
+                                    'fh_matui.datatable.DataTableResource._handle_action': ( 'datatable.html#datatableresource._handle_action',
                                                                                              'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._handle_save': ( 'table.html#datatableresource._handle_save',
+                                    'fh_matui.datatable.DataTableResource._handle_save': ( 'datatable.html#datatableresource._handle_save',
                                                                                            'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._handle_table': ( 'table.html#datatableresource._handle_table',
+                                    'fh_matui.datatable.DataTableResource._handle_table': ( 'datatable.html#datatableresource._handle_table',
                                                                                             'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._paginate': ( 'table.html#datatableresource._paginate',
+                                    'fh_matui.datatable.DataTableResource._paginate': ( 'datatable.html#datatableresource._paginate',
                                                                                         'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._register_routes': ( 'table.html#datatableresource._register_routes',
+                                    'fh_matui.datatable.DataTableResource._register_routes': ( 'datatable.html#datatableresource._register_routes',
                                                                                                'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._success_toast': ( 'table.html#datatableresource._success_toast',
+                                    'fh_matui.datatable.DataTableResource._success_toast': ( 'datatable.html#datatableresource._success_toast',
                                                                                              'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.DataTableResource._wrap_modal': ( 'table.html#datatableresource._wrap_modal',
+                                    'fh_matui.datatable.DataTableResource._wrap_modal': ( 'datatable.html#datatableresource._wrap_modal',
                                                                                           'fh_matui/datatable.py'),
-                                    'fh_matui.datatable._action_menu': ('table.html#_action_menu', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable._page_size_select': ('table.html#_page_size_select', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable._safe_int': ('table.html#_safe_int', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable._to_dict': ('table.html#_to_dict', 'fh_matui/datatable.py'),
-                                    'fh_matui.datatable.table_state_from_request': ( 'table.html#table_state_from_request',
+                                    'fh_matui.datatable._action_menu': ('datatable.html#_action_menu', '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.datatable.table_state_from_request': ( 'datatable.html#table_state_from_request',
                                                                                      'fh_matui/datatable.py')},
             'fh_matui.foundations': { 'fh_matui.foundations.VEnum': ('foundations.html#venum', 'fh_matui/foundations.py'),
                                       'fh_matui.foundations.VEnum.__add__': ('foundations.html#venum.__add__', 'fh_matui/foundations.py'),
@@ -171,6 +171,7 @@ d = { 'settings': { 'branch': 'master',
                                     'fh_matui.web_pages.FAQSection': ('web_pages.html#faqsection', 'fh_matui/web_pages.py'),
                                     'fh_matui.web_pages.FeatureShowcase': ('web_pages.html#featureshowcase', 'fh_matui/web_pages.py'),
                                     'fh_matui.web_pages.FeaturesGrid': ('web_pages.html#featuresgrid', 'fh_matui/web_pages.py'),
+                                    'fh_matui.web_pages.HeroSection': ('web_pages.html#herosection', 'fh_matui/web_pages.py'),
                                     'fh_matui.web_pages.LandingNavBar': ('web_pages.html#landingnavbar', 'fh_matui/web_pages.py'),
                                     'fh_matui.web_pages.LandingPageSimple': ('web_pages.html#landingpagesimple', 'fh_matui/web_pages.py'),
                                     'fh_matui.web_pages.MarkdownSection': ('web_pages.html#markdownsection', 'fh_matui/web_pages.py'),

fh_matui/components.py

@@ -60,7 +60,7 @@ for name, css in BUTTON_SPECIALS.items():
 
 ButtonT = _ButtonChain()
 
-# %% ../nbs/02_components.ipynb 11
+# %% ../nbs/02_components.ipynb 10
 #| code-fold: true
 class _AnchorChain(BeerCssChain):
     """Chainable anchor style helper"""
@@ -84,7 +84,7 @@ for name, css in ANCHOR_SPECIALS.items():
 
 AT = _AnchorChain()
 
-# %% ../nbs/02_components.ipynb 14
+# %% ../nbs/02_components.ipynb 13
 class SpaceT(VEnum):
     """Space types using BeerCSS spacing classes"""
     no_space = 'no-space'
@@ -224,7 +224,7 @@ def Grid(*cells, space=SpaceT.medium_space,
     grid_cls = [t for t in grid_cls if t]
     return Div(*wrapped_cells, cls=stringify(dedupe_preserve_order(grid_cls)), **kwargs)
 
-# %% ../nbs/02_components.ipynb 17
+# %% ../nbs/02_components.ipynb 16
 def DivLAligned(*c, cls='', **kwargs):
     """MonsterUI-compatible left-aligned row using BeerCSS tokens."""
     cls_tokens = normalize_tokens(cls)
@@ -235,7 +235,7 @@ def DivLAligned(*c, cls='', **kwargs):
 
 
 
-# %% ../nbs/02_components.ipynb 19
+# %% ../nbs/02_components.ipynb 18
 def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     """Responsive vertical stack with padding and mobile compatibility."""
     cls_tokens = normalize_tokens(cls)
@@ -253,7 +253,7 @@ def DivVStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     return Div(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
 
-# %% ../nbs/02_components.ipynb 21
+# %% ../nbs/02_components.ipynb 20
 def DivHStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     """Responsive horizontal stack with padding and mobile compatibility."""
     cls_tokens = normalize_tokens(cls)
@@ -271,7 +271,7 @@ def DivHStacked(*c, responsive=True, padding=True, cls='', **kwargs):
     return Div(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
 
-# %% ../nbs/02_components.ipynb 23
+# %% ../nbs/02_components.ipynb 22
 def DivRAligned(*c, cls='', **kwargs):
     """MonsterUI-compatible right-aligned row using BeerCSS tokens."""
     cls_tokens = normalize_tokens(cls)
@@ -280,7 +280,7 @@ def DivRAligned(*c, cls='', **kwargs):
     tokens = [t for t in tokens if t]
     return DivHStacked(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
-# %% ../nbs/02_components.ipynb 25
+# %% ../nbs/02_components.ipynb 24
 def DivCentered(*c, cls='', **kwargs):
     """Center-aligned container using BeerCSS tokens."""
     cls_tokens = normalize_tokens(cls)
@@ -289,7 +289,7 @@ def DivCentered(*c, cls='', **kwargs):
     tokens = [t for t in tokens if t]
     return Div(*c, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
-# %% ../nbs/02_components.ipynb 27
+# %% ../nbs/02_components.ipynb 26
 def DivFullySpaced(*c, cls='', **kwargs):
     """Row with children stretched to far ends using BeerCSS `max` spacers."""
     cls_tokens = normalize_tokens(cls)
@@ -310,7 +310,7 @@ def DivFullySpaced(*c, cls='', **kwargs):
         base = spaced_children
     return Div(*base, cls=stringify(dedupe_preserve_order(tokens)), **kwargs)
 
-# %% ../nbs/02_components.ipynb 30
+# %% ../nbs/02_components.ipynb 29
 #| code-fold: true
 def Icon(icon: str, size: str = None, fill: bool = False, cls = (), **kwargs):
     """Material Design icon with optional size and fill"""
@@ -321,7 +321,7 @@ def Icon(icon: str, size: str = None, fill: bool = False, cls = (), **kwargs):
     cls_str = ' '.join(icon_cls) if icon_cls else None
     return I(icon, cls=cls_str, **kwargs) if cls_str else I(icon, **kwargs)
 
-# %% ../nbs/02_components.ipynb 33
+# %% ../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"""
@@ -330,7 +330,7 @@ def NavBar(*children, brand=None, sticky=False, cls='', **kwargs):
         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)
 
-# %% ../nbs/02_components.ipynb 36
+# %% ../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."""
     modal_cls = normalize_tokens(cls)
@@ -398,7 +398,7 @@ def ModalFooter(*c, cls=(), **kwargs):
     footer_cls.extend(['right-align', 'no-space'])
     return Nav(*c, cls=' '.join(footer_cls), **kwargs)
 
-# %% ../nbs/02_components.ipynb 39
+# %% ../nbs/02_components.ipynb 38
 #| code-fold: true
 def Field(*c, label: bool = False, prefix: bool = False, suffix: bool = False, cls = '', **kwargs):
     """BeerCSS field wrapper for inputs with border/label/prefix/suffix styling."""
@@ -423,7 +423,7 @@ def LabelInput(label: str, id: str = None, placeholder: str = None, input_type:
     if suffix_icon: children.append(I(suffix_icon))
     return Field(*children, label=True, prefix=bool(prefix_icon), suffix=bool(suffix_icon), cls=cls)
 
-# %% ../nbs/02_components.ipynb 42
+# %% ../nbs/02_components.ipynb 41
 #| code-fold: true
 def LabelInput(label: str, id: str = None, placeholder: str = None, input_type: str = 'text',
                prefix_icon: str = None, suffix_icon: str = None, value: str = None, cls = '', **kwargs):
@@ -445,7 +445,7 @@ def FormLabel(*c, cls=(), **kwargs):
     if cls_str: return Label(*c, cls=cls_str, **kwargs)
     return Label(*c, **kwargs)
 
-# %% ../nbs/02_components.ipynb 45
+# %% ../nbs/02_components.ipynb 44
 #| code-fold: true
 def CheckboxX(*c, cls=(), **kwargs):
     """BeerCSS checkbox with label support."""
@@ -455,7 +455,7 @@ def CheckboxX(*c, cls=(), **kwargs):
     cls_str = stringify(checkbox_cls)
     return Label(Input(type='checkbox', **kwargs), Span(label_text) if label_text else Span(), cls=cls_str)
 
-# %% ../nbs/02_components.ipynb 48
+# %% ../nbs/02_components.ipynb 47
 #| code-fold: true
 def Radio(*c, cls=(), **kwargs):
     """BeerCSS radio button with label."""
@@ -465,7 +465,7 @@ def Radio(*c, cls=(), **kwargs):
     cls_str = stringify(radio_cls)
     return Label(Input(type='radio', **kwargs), Span(label_text) if label_text else Span(), cls=cls_str)
 
-# %% ../nbs/02_components.ipynb 51
+# %% ../nbs/02_components.ipynb 50
 #| code-fold: true
 def Switch(*c, cls=(), **kwargs):
     """BeerCSS toggle switch for on/off states.
@@ -492,7 +492,7 @@ def Switch(*c, cls=(), **kwargs):
         cls='middle-align'
     )
 
-# %% ../nbs/02_components.ipynb 54
+# %% ../nbs/02_components.ipynb 53
 #| code-fold: true
 def TextArea(*c, cls=(), **kwargs):
     """BeerCSS textarea with field wrapper for consistent styling."""
@@ -500,7 +500,7 @@ def TextArea(*c, cls=(), **kwargs):
     textarea = Textarea(content, **kwargs) if content else Textarea(**kwargs)
     return Field(textarea, cls=cls)
 
-# %% ../nbs/02_components.ipynb 57
+# %% ../nbs/02_components.ipynb 56
 #| code-fold: true
 def Range(*c, min=None, max=None, step=None, cls=(), **kwargs):
     """BeerCSS range slider with two-tone fill effect."""
@@ -529,7 +529,7 @@ def Range(*c, min=None, max=None, step=None, cls=(), **kwargs):
     style = f"--_start: 0%; --_end: {percentage:.1f}%;"
     return Label(Input(**input_attrs), Span(), cls=cls_str, style=style)
 
-# %% ../nbs/02_components.ipynb 60
+# %% ../nbs/02_components.ipynb 59
 #| code-fold: true
 def Select(*items, value='', placeholder='Select...', prefix_icon=None, name='', cls=(), **kwargs):
     """BeerCSS menu-based select dropdown with rich styling."""
@@ -554,7 +554,7 @@ def Select(*items, value='', placeholder='Select...', prefix_icon=None, name='',
     cls_str = stringify(field_cls)
     return Div(*children, cls=cls_str)
 
-# %% ../nbs/02_components.ipynb 69
+# %% ../nbs/02_components.ipynb 68
 #| code-fold: true
 def FormGrid(*c, cols: int = 1):
     """Responsive grid layout for form fields that stacks on mobile."""
@@ -563,7 +563,7 @@ def FormGrid(*c, cols: int = 1):
     wrapped = [Div(child, cls=col_cls) for child in c]
     return Div(*wrapped, cls="grid")
 
-# %% ../nbs/02_components.ipynb 72
+# %% ../nbs/02_components.ipynb 71
 #| code-fold: true
 def Progress(*c, value='', max='100', cls=(), **kwargs):
     """Linear progress bar with value/max support."""
@@ -575,7 +575,7 @@ def Progress(*c, value='', max='100', cls=(), **kwargs):
     if cls_str: return fc.Progress(*c, cls=cls_str, **progress_attrs)
     return fc.Progress(*c, **progress_attrs)
 
-# %% ../nbs/02_components.ipynb 75
+# %% ../nbs/02_components.ipynb 74
 #| code-fold: true
 def LoadingIndicator(size='medium', cls='', **kwargs):
     """BeerCSS circular spinner for async operations."""
@@ -583,7 +583,7 @@ def LoadingIndicator(size='medium', cls='', **kwargs):
     progress_cls = f"circle {size_cls} {cls}".strip()
     return fc.Progress(cls=progress_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 78
+# %% ../nbs/02_components.ipynb 77
 #| code-fold: true
 def Table(*c, cls = 'border', **kwargs):
     """BeerCSS table with optional border/stripes classes."""
@@ -651,14 +651,14 @@ def TableFromDicts(header_data, body_data, footer_data = None, header_cell_rende
         Tfoot(Tr(*[footer_cell_render(k, footer_data.get(k, '')) for k in header_data])) if footer_data else None,
         cls=cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 81
+# %% ../nbs/02_components.ipynb 80
 #| code-fold: true
 def TableControls(*controls, cls='', **kwargs):
     """Toolbar container for table filters, search, and actions."""
     controls_cls = f"padding middle-align space {cls}".strip()
     return Div(*controls, cls=controls_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 84
+# %% ../nbs/02_components.ipynb 83
 #| code-fold: true
 def Pagination(current_page: int, total_pages: int, hx_get: str, hx_target: str = '#table-container',
                show_first_last: bool = True, cls='', **kwargs):
@@ -693,7 +693,7 @@ def Pagination(current_page: int, total_pages: int, hx_get: str, hx_target: str
     nav_cls = f"center-align middle-align {cls}".strip()
     return Nav(*buttons, cls=nav_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 87
+# %% ../nbs/02_components.ipynb 86
 #| code-fold: true
 def Card(*c, header = None, footer = None, body_cls = 'padding', header_cls = (), footer_cls = (), cls = (), **kwargs):
     """BeerCSS card with optional header/footer sections."""
@@ -707,7 +707,7 @@ def Card(*c, header = None, footer = None, body_cls = 'padding', header_cls = ()
     if footer is not None: sections.append(Nav(footer, cls=footer_cls) if footer_cls else Nav(footer))
     return Article(*sections, cls=cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 90
+# %% ../nbs/02_components.ipynb 89
 #| code-fold: true
 def Toolbar(*items, cls='', elevate='large', fill=True, **kwargs):
     """BeerCSS toolbar for action bars with elevation options."""
@@ -717,7 +717,7 @@ 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 93
+# %% ../nbs/02_components.ipynb 92
 #| 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."""
@@ -741,7 +741,7 @@ def Snackbar(*c, **kwargs):
     """Alias for Toast component."""
     return Toast(*c, **kwargs)
 
-# %% ../nbs/02_components.ipynb 95
+# %% ../nbs/02_components.ipynb 94
 #| code-fold: true
 class ContainerT(VEnum):
     """Container size options (BeerCSS). Most alias to 'responsive'; use 'expand' for full-width."""
@@ -752,7 +752,7 @@ class ContainerT(VEnum):
     xl = 'responsive'
     expand = 'responsive max'
 
-# %% ../nbs/02_components.ipynb 97
+# %% ../nbs/02_components.ipynb 96
 #| code-fold: true
 def _get_form_config(col: dict) -> dict:
     """Extract form config from column, with sensible defaults."""
@@ -828,7 +828,7 @@ def FormField(
             **attrs
         )
 
-# %% ../nbs/02_components.ipynb 99
+# %% ../nbs/02_components.ipynb 98
 #| code-fold: true
 from typing import Callable, Any
 
@@ -947,7 +947,7 @@ def FormModal(
         cls="large-width"
     )
 
-# %% ../nbs/02_components.ipynb 101
+# %% ../nbs/02_components.ipynb 100
 #| 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 +1004,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 104
+# %% ../nbs/02_components.ipynb 103
 #| code-fold: true
 def NavSideBarHeader(*c, cls='', **kwargs):
     """Sidebar header section for menu buttons and branding."""
@@ -1024,7 +1024,7 @@ def NavSideBarContainer(*children, position='left', size='m', cls='', active=Fal
     nav_cls = f"{base_cls} {cls}".strip()
     return Nav(*children, cls=nav_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 106
+# %% ../nbs/02_components.ipynb 105
 #| 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):
@@ -1069,7 +1069,7 @@ def Layout(*content, sidebar=None, sidebar_links=None, nav_bar=None, container_s
     final_cls = f"surface-container {cls}".strip() if cls else "surface-container"
     return Div(*layout_children, cls=final_cls, **kwargs)
 
-# %% ../nbs/02_components.ipynb 110
+# %% ../nbs/02_components.ipynb 109
 #| code-fold: true
 class TextT(VEnum):
     """Text styles using BeerCSS typography classes."""
@@ -1101,7 +1101,7 @@ class TextPresets(VEnum):
     primary_link = 'link primary-text'
     muted_link = 'link secondary-text'
 
-# %% ../nbs/02_components.ipynb 111
+# %% ../nbs/02_components.ipynb 110
 #| code-fold: true
 def CodeSpan(*c, cls=(), **kwargs):
     """Inline code snippet."""
@@ -1157,7 +1157,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 113
+# %% ../nbs/02_components.ipynb 112
 #| code-fold: true
 def FAQItem(question: str, answer: str, question_cls: str = '', answer_cls: str = ''):
     """Collapsible FAQ item using details/summary.
@@ -1175,7 +1175,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 117
+# %% ../nbs/02_components.ipynb 116
 #| 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/datatable.py

@@ -1,11 +1,11 @@
 """Data table with pagination, search, sorting, and inline actions"""
 
-# AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/05_table.ipynb.
+# AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/05_datatable.ipynb.
 
 # %% auto 0
 __all__ = ['PAGE_SIZES', 'table_state_from_request', 'DataTable', 'DataTableResource']
 
-# %% ../nbs/05_table.ipynb 2
+# %% ../nbs/05_datatable.ipynb 2
 from fastcore.utils import *
 from fasthtml.common import *
 from fasthtml.jupyter import *
@@ -17,7 +17,7 @@ from .core import *
 from nbdev.showdoc import show_doc
 from .components import *
 
-# %% ../nbs/05_table.ipynb 6
+# %% ../nbs/05_datatable.ipynb 6
 #| code-fold: true
 from math import ceil
 from urllib.parse import urlencode
@@ -288,7 +288,7 @@ def DataTable(
     
     return Div(card, Div(id=feedback_id), id=container_id)
 
-# %% ../nbs/05_table.ipynb 8
+# %% ../nbs/05_datatable.ipynb 8
 from typing import Callable, Optional, Any, Union
 from dataclasses import asdict, is_dataclass
 from datetime import datetime

fh_matui/web_pages.py

@@ -3,30 +3,97 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/04_web_pages.ipynb.
 
 # %% auto 0
-__all__ = ['SECTION_STYLE', 'SECTION_MARGIN', 'STANDARD_FOOTER_COLUMNS', 'FeatureShowcase', 'FeaturesGrid', 'PricingSection',
-           'FAQSection', 'PageFooter', 'LandingNavBar', 'LandingPageSimple', 'MarkdownSection', 'ContentPage']
+__all__ = ['SECTION_STYLE', 'SECTION_MARGIN', 'STANDARD_FOOTER_COLUMNS', 'HeroSection', 'FeatureShowcase', 'FeaturesGrid',
+           'PricingSection', 'FAQSection', 'PageFooter', 'LandingNavBar', 'LandingPageSimple', 'MarkdownSection',
+           'ContentPage']
 
 # %% ../nbs/04_web_pages.ipynb 3
 import importlib
 import markdown
-
-
-
 from .components import *
 from .core import *
 from fasthtml.common import *
 from .app_pages import *
 from .foundations import *
-
 from fastcore.utils import partial
 from fasthtml.common import *
 from fasthtml.jupyter import FastHTML, fast_app, JupyUvi, HTMX
 from fastlite import *
 import fasthtml.components as fc
 from fasthtml.common import A, Button as FhButton, I, Span
-import socket
-import time
-import subprocess
+
+
+# %% ../nbs/04_web_pages.ipynb 6
+def HeroSection(
+    title: str,              # Main hero title
+    subtitle: str,           # Hero subtitle/description
+    primary_cta_text: str,   # Primary CTA button text
+    primary_cta_href: str,   # Primary CTA button href
+    secondary_cta_text: str = None,  # Secondary CTA button text (optional)
+    secondary_cta_href: str = None,  # Secondary CTA button href (optional)
+    background: str = "primary-container",  # BeerCSS background class (without bg- prefix)
+    cls: str = "",  # Additional classes
+    extra_css: str | None = None,  # Optional custom CSS (minimal; opt-in)
+    extra_js: str | None = None,  # Optional custom JS (minimal; opt-in)
+):
+    """Hero section with title, subtitle, and CTA buttons.
+    
+    BeerCSS-first styling. Takes up 75vh by default with gradient overlay.
+    Designed for full-width layout - background extends edge-to-edge naturally.
+    Content is centered using responsive class internally.
+    """
+    # Hero styling: 75vh height + gradient overlay
+    # No width hacks needed - parent layout uses "max" for full-width
+    hero_css = """
+    .hero-section {
+        min-height: 75vh;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        position: relative;
+        background: linear-gradient(135deg, 
+            var(--primary-container) 0%, 
+            var(--surface-container) 50%,
+            var(--secondary-container) 100%);
+    }
+    .hero-section::before {
+        content: '';
+        position: absolute;
+        inset: 0;
+        background: radial-gradient(circle at 20% 80%, var(--primary) 0%, transparent 50%),
+                    radial-gradient(circle at 80% 20%, var(--secondary) 0%, transparent 50%);
+        opacity: 0.1;
+        pointer-events: none;
+    }
+    .hero-content {
+        position: relative;
+        z-index: 1;
+    }
+    """
+    
+    hooks = [Style(hero_css)]
+    if extra_css:
+        hooks.append(Style(extra_css))
+    if extra_js:
+        hooks.append(Script(extra_js))
+    
+    ctas = [Button(primary_cta_text, href=primary_cta_href, variant="raised")]
+    if secondary_cta_text and secondary_cta_href:
+        ctas.append(Button(secondary_cta_text, href=secondary_cta_href, variant="outlined"))
+    
+    stack = DivVStacked(
+        H1(title, cls="no-margin"),
+        P(subtitle, cls="secondary-text large-text"),
+        Div(*ctas, cls="row middle-align center-align small-space"),
+        cls="center-align large-padding hero-content",
+    )
+    # Content centered with responsive class
+    content = Div(stack, cls="responsive")
+    return Section(
+        *hooks,
+        content,
+        cls=f"hero-section {cls}".strip(),
+    )
 
 # %% ../nbs/04_web_pages.ipynb 10
 def FeatureShowcase(

{fh_matui-0.9.1.dist-info → fh_matui-0.9.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fh-matui
-Version: 0.9.1
+Version: 0.9.3
 Summary: material-ui for fasthtml
 Home-page: https://github.com/abhisheksreesaila/fh-matui
 Author: abhishek sreesaila
@@ -18,6 +18,9 @@ Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: python-fasthtml
+Requires-Dist: fastcore
+Requires-Dist: markdown
 Provides-Extra: dev
 Dynamic: author
 Dynamic: author-email
@@ -29,6 +32,7 @@ Dynamic: keywords
 Dynamic: license
 Dynamic: license-file
 Dynamic: provides-extra
+Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
@@ -140,12 +144,12 @@ fh-matui automatically includes:
 
 | Module | Description | Key Components |
 |--------|-------------|----------------|
-| [Foundations](foundations.html) | Base utilities and helper functions | `BeerHeaders`, `display`, styling helpers |
-| [Core](core.html) | Theme system and styling | `MatTheme`, color presets, theme configuration |
-| [Components](components.html) | UI component library | `Button`, [`Card`](https://abhisheksreesaila.github.io/fh-matui/components.html#card), [`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield), [`FormModal`](https://abhisheksreesaila.github.io/fh-matui/components.html#formmodal), [`Grid`](https://abhisheksreesaila.github.io/fh-matui/components.html#grid) |
-| [App Pages](app_pages.html) | Application layouts | Navigation, sidebars, full-page layouts |
-| [Data Tables](05_table.html) | Data management components | [`DataTable`](https://abhisheksreesaila.github.io/fh-matui/table.html#datatable), [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/table.html#datatableresource), CRUD operations |
-| [Web Pages](web_pages.html) | Marketing/landing pages | Hero sections, feature grids, testimonials |
+| [Foundations](https://abhisheksreesaila.github.io/fh-matui/foundations.html) | Base utilities and helper functions | `BeerHeaders`, `display`, styling helpers |
+| [Core](https://abhisheksreesaila.github.io/fh-matui/core.html) | Theme system and styling | `MatTheme`, color presets, theme configuration |
+| [Components](https://abhisheksreesaila.github.io/fh-matui/components.html) | UI component library | `Button`, `Card`, `FormField`, `FormModal`, `Grid` |
+| [App Pages](https://abhisheksreesaila.github.io/fh-matui/app_pages.html) | Application layouts | Navigation, sidebars, full-page layouts |
+| [Data Tables](https://abhisheksreesaila.github.io/fh-matui/datatable.html) | Data management components | `DataTable`, `DataTableResource`, CRUD operations |
+| [Web Pages](https://abhisheksreesaila.github.io/fh-matui/web_pages.html) | Marketing/landing pages | Hero sections, feature grids, testimonials |
 
 ## 🛠️ Development
 

fh_matui-0.9.3.dist-info/RECORD

@@ -0,0 +1,14 @@
+fh_matui/__init__.py,sha256=5uBZ3sUaocnyIWuJeW9M94Z77vA1kKmwKxiblrnbKlc,23
+fh_matui/_modidx.py,sha256=hLZ_V7aRsAvavJ82m02XyvImfzYB5_DnOce8eKRD3xU,22865
+fh_matui/app_pages.py,sha256=Sn9-tgBpaPNbR-0nZtPLoSCmAWLOGB4UQ88IkFvzBRY,10361
+fh_matui/components.py,sha256=KjdTHzWRXpVWBEIGskW1HfhjPpzRYzi6UA_yRjZyMWM,48254
+fh_matui/core.py,sha256=xtVBN8CtC50ZJ4Iu7o-mUhaA87tWdnz8gBfKRk63Zhs,10680
+fh_matui/datatable.py,sha256=MAEibyjRwYlBLMD9dIIocufuWn84jTvrgRt1XKFAN9U,25506
+fh_matui/foundations.py,sha256=b7PnObJpKN8ZAU9NzCm9xpfnHzFjjAROU7E2YvA_tj4,1820
+fh_matui/web_pages.py,sha256=4mF-jpfVcZTVepfQ-aMGgIUp-nBp0YCkvcdsWhUYeaA,34879
+fh_matui-0.9.3.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
+fh_matui-0.9.3.dist-info/METADATA,sha256=KX2VQz5wOPRHaSwtc86l3-p3TTjn-08pjuS7kAHbta8,8431
+fh_matui-0.9.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fh_matui-0.9.3.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
+fh_matui-0.9.3.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
+fh_matui-0.9.3.dist-info/RECORD,,

fh_matui-0.9.1.dist-info/RECORD

@@ -1,14 +0,0 @@
-fh_matui/__init__.py,sha256=Y6W8oeFa2EC4luE43Qn41YddoEfesw76EJ4Lj0NkhIQ,21
-fh_matui/_modidx.py,sha256=GqigyZE6TkLMfflOcgGzo1CjBiSxIY5ez_DyO6qApjQ,22665
-fh_matui/app_pages.py,sha256=Sn9-tgBpaPNbR-0nZtPLoSCmAWLOGB4UQ88IkFvzBRY,10361
-fh_matui/components.py,sha256=S5rbnPdkGH2rhOpRR007uU7Sof7PAmPIKRDII3fBqb8,48254
-fh_matui/core.py,sha256=xtVBN8CtC50ZJ4Iu7o-mUhaA87tWdnz8gBfKRk63Zhs,10680
-fh_matui/datatable.py,sha256=G7Gmkj5nNWbcWqZvJtWGUSKQSs8AQAcs57qEpMt1ijo,25490
-fh_matui/foundations.py,sha256=b7PnObJpKN8ZAU9NzCm9xpfnHzFjjAROU7E2YvA_tj4,1820
-fh_matui/web_pages.py,sha256=PQs_1elTdC1lkx1MNTW4yD_zaAXLtxzKX8JFuIP4Iw0,32130
-fh_matui-0.9.1.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
-fh_matui-0.9.1.dist-info/METADATA,sha256=G-u13Lvhv0mrVWgpee4tEKqWDwml1I4A4CsAlI5nPVc,8486
-fh_matui-0.9.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fh_matui-0.9.1.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
-fh_matui-0.9.1.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
-fh_matui-0.9.1.dist-info/RECORD,,