fh-matui 0.9.4__py3-none-any.whl → 0.9.5__py3-none-any.whl

fh_matui/_modidx.py

@@ -128,10 +128,15 @@ 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': ('datatable.html#datatable', 'fh_matui/datatable.py'),
+            'fh_matui.datatable': { 'fh_matui.datatable.CrudContext': ('datatable.html#crudcontext', 'fh_matui/datatable.py'),
+                                    '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._build_context': ( 'datatable.html#datatableresource._build_context',
+                                                                                             'fh_matui/datatable.py'),
+                                    'fh_matui.datatable.DataTableResource._call_hook': ( 'datatable.html#datatableresource._call_hook',
+                                                                                         'fh_matui/datatable.py'),
                                     'fh_matui.datatable.DataTableResource._error_toast': ( 'datatable.html#datatableresource._error_toast',
                                                                                            'fh_matui/datatable.py'),
                                     'fh_matui.datatable.DataTableResource._filter_by_search': ( 'datatable.html#datatableresource._filter_by_search',

fh_matui/datatable.py

@@ -3,7 +3,7 @@
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/05_datatable.ipynb.
 
 # %% auto 0
-__all__ = ['PAGE_SIZES', 'table_state_from_request', 'DataTable', 'DataTableResource']
+__all__ = ['PAGE_SIZES', 'logger', 'table_state_from_request', 'DataTable', 'CrudContext', 'DataTableResource']
 
 # %% ../nbs/05_datatable.ipynb 2
 from fastcore.utils import *
@@ -17,7 +17,7 @@ from .core import *
 from nbdev.showdoc import show_doc
 from .components import *
 
-# %% ../nbs/05_datatable.ipynb 6
+# %% ../nbs/05_datatable.ipynb 7
 #| code-fold: true
 from math import ceil
 from urllib.parse import urlencode
@@ -288,7 +288,102 @@ def DataTable(
     
     return Div(card, Div(id=feedback_id), id=container_id)
 
-# %% ../nbs/05_datatable.ipynb 8
+# %% ../nbs/05_datatable.ipynb 9
+import asyncio
+import logging
+from dataclasses import dataclass
+from typing import Callable, Any, Optional
+from starlette.responses import HTMLResponse
+
+logger = logging.getLogger(__name__)
+
+@dataclass
+class CrudContext:
+    """
+    🎯 Context object passed to enhanced CRUD operation hooks.
+    
+    Provides rich access to request state, user info, database, and record data.
+    Perfect for implementing complex business logic and external API integration.
+    
+    ## 📦 Fields
+    
+    - `request`: Full Starlette request object (headers, query params, session, state)
+    - `user`: Current user dict from `request.state.user` (if available)
+    - `db`: Database instance from `request.state.tenant_db` (if available)
+    - `tbl`: Table instance from `request.state.tables[table_name]` (if available)
+    - `record`: Form data dict with field values
+    - `record_id`: Record ID for update/delete operations (None for create)
+    
+    ## 💡 Usage in Hooks
+    
+    ### Example: Create with External API
+    ```python
+    async def quiltt_create_connection(ctx: CrudContext) -> dict:
+        # Access user info
+        user_id = ctx.user['user_id']
+        
+        # Call external API
+        api = QuilttClient()
+        response = await api.create_connection(
+            institution=ctx.record['institution_name'],
+            user_id=user_id
+        )
+        
+        # Enrich record with API response
+        ctx.record['connection_id'] = response['id']
+        ctx.record['account_id'] = response['account_id']
+        ctx.record['status'] = 'pending'
+        
+        return ctx.record  # DataTableResource will insert this
+    
+    DataTableResource(
+        ...,
+        on_create=quiltt_create_connection  # 🆕 Enhanced hook
+    )
+    ```
+    
+    ### Example: Soft Delete
+    ```python
+    def soft_delete_budget(ctx: CrudContext) -> None:
+        # Access table directly
+        ctx.tbl.update({
+            'id': ctx.record_id,
+            'is_deleted': True,
+            'deleted_at': datetime.now().isoformat(),
+            'deleted_by': ctx.user['user_id']
+        })
+        # No return needed for delete hooks
+    
+    DataTableResource(
+        ...,
+        on_delete=soft_delete_budget,  # 🆕 Custom delete logic
+        get_table=lambda req: req.state.tables['budgets']
+    )
+    ```
+    
+    ### Example: Update with Sync
+    ```python
+    async def sync_transaction_update(ctx: CrudContext) -> dict:
+        # Update external API first
+        api = TransactionAPI()
+        await api.update_transaction(
+            transaction_id=ctx.record_id,
+            data=ctx.record
+        )
+        
+        # Add sync timestamp
+        ctx.record['last_synced'] = datetime.now().isoformat()
+        return ctx.record
+    ```
+    """
+    request: Any                     # Full Starlette request
+    user: Optional[dict] = None      # request.state.user (if available)
+    db: Optional[Any] = None         # request.state.tenant_db (if available)
+    tbl: Optional[Any] = None        # request.state.tables[table_name] (if available)
+    record: dict = None              # Form data dict
+    record_id: Optional[Any] = None  # ID for update/delete (None for create)
+
+# %% ../nbs/05_datatable.ipynb 12
 from typing import Callable, Optional, Any, Union
 from dataclasses import asdict, is_dataclass
 from datetime import datetime
@@ -309,7 +404,20 @@ def _to_dict(obj: Any) -> dict:
 
 
 class DataTableResource:
-    "High-level resource that auto-registers all routes for a data table."
+    """
+    🔧 High-level resource that auto-registers all routes for a data table.
+    
+    **Features:**
+    - Custom CRUD hooks with `CrudContext` for rich business logic
+    - Async/sync hook support for external API integration
+    - Auto-refresh table via HX-Trigger after mutations
+    - Request state accessors for multi-tenant apps
+    
+    **Auto-registers 3 routes:**
+    - `GET {base_route}` → DataTable list view
+    - `GET {base_route}/action` → FormModal for create/edit/view/delete
+    - `POST {base_route}/save` → Save handler with hooks
+    """
     
     def __init__(
         self,
@@ -328,15 +436,16 @@ class DataTableResource:
         search_placeholder: str = "Search...",
         create_label: str = "New Record",
         empty_message: str = "No records found.",
-        # Lifecycle hooks
-        on_before_create: Callable[[dict], dict] = None,
-        on_after_create: Callable[[Any], None] = None,
-        on_before_update: Callable[[Any, dict], dict] = None,
-        on_after_update: Callable[[Any], None] = None,
-        on_before_delete: Callable[[Any], bool] = None,
-        on_after_delete: Callable[[Any], None] = None,
+        # CRUD Hooks (with CrudContext)
+        on_create: Callable[[CrudContext], dict] = None,
+        on_update: Callable[[CrudContext], dict] = None,
+        on_delete: Callable[[CrudContext], None] = None,
         # Multi-tenant
         user_filter: Callable = None,
+        # Request state accessors (for CrudContext)
+        get_user: Callable = None,
+        get_db: Callable = None,
+        get_table: Callable = None,
         # Custom generators
         id_generator: Callable[[], Any] = None,
         timestamp_fields: dict = None
@@ -359,24 +468,26 @@ class DataTableResource:
         # Determine CRUD ops from provided functions
         if crud_ops is None:
             self.crud_ops = {
-                "create": create is not None,
-                "update": update is not None,
-                "delete": delete is not None
+                "create": create is not None or on_create is not None,
+                "update": update is not None or on_update is not None,
+                "delete": delete is not None or on_delete is not None
             }
         else:
             self.crud_ops = crud_ops
         
-        # Lifecycle hooks
-        self.on_before_create = on_before_create
-        self.on_after_create = on_after_create
-        self.on_before_update = on_before_update
-        self.on_after_update = on_after_update
-        self.on_before_delete = on_before_delete
-        self.on_after_delete = on_after_delete
+        # CRUD hooks
+        self.on_create_hook = on_create
+        self.on_update_hook = on_update
+        self.on_delete_hook = on_delete
         
         # Multi-tenant
         self.user_filter = user_filter
         
+        # Request state accessors
+        self.get_user = get_user
+        self.get_db = get_db
+        self.get_table = get_table
+        
         # Generators
         self.id_generator = id_generator
         self.timestamp_fields = timestamp_fields or {}
@@ -385,25 +496,68 @@ class DataTableResource:
         self.container_id = f"crud-table-{base_route.replace('/', '-').strip('-')}"
         self.feedback_id = f"{self.container_id}-feedback"
         self.modal_id = f"{self.container_id}-modal"
+        self.refresh_trigger = f"{self.container_id}-refresh"
         
         # Register routes
         self._register_routes()
     
+    async def _call_hook(self, hook, ctx: CrudContext):
+        """🔄 Call hook function, handling both sync and async."""
+        if hook is None:
+            return None
+        if asyncio.iscoroutinefunction(hook):
+            return await hook(ctx)
+        return hook(ctx)
+    
+    def _build_context(self, req, record: dict = None, record_id: Any = None) -> CrudContext:
+        """🏗️ Build CrudContext from request state."""
+        user = None
+        db = None
+        tbl = None
+        
+        try:
+            if self.get_user and callable(self.get_user):
+                user = self.get_user(req)
+            elif hasattr(req, 'state') and hasattr(req.state, 'user'):
+                user = req.state.user
+        except AttributeError:
+            pass
+        
+        try:
+            if self.get_db and callable(self.get_db):
+                db = self.get_db(req)
+            elif hasattr(req, 'state') and hasattr(req.state, 'tenant_db'):
+                db = req.state.tenant_db
+        except AttributeError:
+            pass
+        
+        try:
+            if self.get_table and callable(self.get_table):
+                tbl = self.get_table(req)
+        except AttributeError:
+            pass
+        
+        return CrudContext(
+            request=req,
+            user=user,
+            db=db,
+            tbl=tbl,
+            record=record or {},
+            record_id=record_id
+        )
+    
     def _register_routes(self):
         """Register all data table routes with the app."""
         rt = self.app.route
         
-        # Main table route
         @rt(self.base_route)
         def _table_handler(req):
             return self._handle_table(req)
         
-        # Action route (view/edit/create/delete)
         @rt(f"{self.base_route}/action")
         def _action_handler(req):
             return self._handle_action(req)
         
-        # Save route (form submission)
         @rt(f"{self.base_route}/save")
         async def _save_handler(req):
             return await self._handle_save(req)
@@ -411,11 +565,8 @@ class DataTableResource:
     def _get_filtered_data(self, req) -> list:
         """Get all data, optionally filtered by user_filter."""
         all_data = self.get_all()
-        
-        # Convert to list of dicts
         data = [_to_dict(item) for item in all_data]
         
-        # Apply user filter if provided
         if self.user_filter and callable(self.user_filter):
             filter_criteria = self.user_filter(req)
             if filter_criteria:
@@ -423,7 +574,6 @@ class DataTableResource:
                     row for row in data
                     if all(row.get(k) == v for k, v in filter_criteria.items())
                 ]
-        
         return data
     
     def _filter_by_search(self, data: list, search: str) -> list:
@@ -437,7 +587,6 @@ class DataTableResource:
             if col.get("searchable", False)
         ]
         
-        # If no columns marked searchable, search all
         if not searchable_keys:
             searchable_keys = [col["key"] for col in self.columns]
         
@@ -451,26 +600,19 @@ class DataTableResource:
         total = len(data)
         total_pages = max(1, ceil(total / page_size))
         page = min(max(1, page), total_pages)
-        
         start = (page - 1) * page_size
         end = start + page_size
-        
         return data[start:end], total, page
     
     def _handle_table(self, req):
         """Handle main table route."""
-        # Extract pagination state
         state = table_state_from_request(req, page_sizes=self.page_sizes)
         search, page, page_size = state["search"], state["page"], state["page_size"]
         
-        # Get and filter data
         data = self._get_filtered_data(req)
         filtered = self._filter_by_search(data, search)
-        
-        # Paginate
         page_data, total, page = self._paginate(filtered, page, page_size)
         
-        # Build table
         table = DataTable(
             data=page_data,
             total=total,
@@ -489,31 +631,40 @@ class DataTableResource:
             empty_message=self.empty_message
         )
         
-        return table
+        # Wrap table in auto-refresh container
+        params = urlencode({"search": search, "page": page, "page_size": page_size})
+        table_container = Div(
+            table,
+            id=self.container_id,
+            hx_trigger=f"{self.refresh_trigger} from:body",
+            hx_get=f"{self.base_route}?{params}",
+            hx_target=f"#{self.container_id}",
+            hx_swap="outerHTML"
+        )
+        
+        feedback = Div(id=self.feedback_id)
+        return Div(feedback, table_container)
     
     def _handle_action(self, req):
         """Handle action route (view/edit/create/delete)."""
         params = getattr(req, "query_params", {})
         getter = params.get if hasattr(params, "get") else (lambda k, d=None: params[k] if k in params else d)
         
-        # Handle dismiss
         if getter("dismiss") is not None:
             return Div(id=self.feedback_id)
         
         record_id = getter("id")
-        # Try to convert to int if numeric
         if record_id:
             try:
                 record_id = int(record_id)
             except (TypeError, ValueError):
-                pass  # Keep as string (e.g., UUID)
+                pass
         
         action = (getter("action", "view") or "view").lower()
         search = getter("search", "") or ""
         page = _safe_int(getter("page", 1), 1)
         page_size = _safe_int(getter("page_size", 10), 10)
         
-        # URLs
         return_params = urlencode({"search": search, "page": page, "page_size": page_size})
         cancel_url = f"{self.base_route}/action?dismiss=1"
         save_url = f"{self.base_route}/save?{return_params}"
@@ -581,21 +732,23 @@ class DataTableResource:
             if not self.crud_ops.get("delete"):
                 return self._error_toast("Delete operation not enabled.")
             
-            # Check before_delete hook
-            if self.on_before_delete:
-                if not self.on_before_delete(record_id):
-                    return self._error_toast("Delete cancelled by validation.")
-            
-            # Perform delete
             try:
-                self.delete_fn(record_id)
+                ctx = self._build_context(req, record=record, record_id=record_id)
                 
-                # After delete hook
-                if self.on_after_delete:
-                    self.on_after_delete(record_id)
+                # Use on_delete hook if provided
+                if self.on_delete_hook:
+                    if asyncio.iscoroutinefunction(self.on_delete_hook):
+                        loop = asyncio.get_event_loop()
+                        loop.run_until_complete(self.on_delete_hook(ctx))
+                    else:
+                        self.on_delete_hook(ctx)
+                else:
+                    # Default: use delete_fn
+                    self.delete_fn(record_id)
                 
-                return self._success_toast(f"Record deleted successfully.")
+                return self._success_toast("Record deleted successfully.")
             except Exception as e:
+                logger.error(f"Delete failed: {e}", exc_info=True)
                 return self._error_toast(f"Delete failed: {str(e)}")
         
         return Div(id=self.feedback_id)
@@ -606,14 +759,13 @@ class DataTableResource:
             form_data = await req.form()
             record_id = form_data.get(self.row_id_field)
             
-            # Try to convert ID
             if record_id:
                 try:
                     record_id = int(record_id)
                 except (TypeError, ValueError):
                     pass
             
-            # Build data dict from form, excluding the ID field
+            # Build data dict from form
             data = {}
             for col in self.columns:
                 key = col["key"]
@@ -626,7 +778,6 @@ class DataTableResource:
                 
                 value = form_data.get(key)
                 
-                # Type conversion based on form config
                 field_type = form_cfg.get("type", "text")
                 if field_type == "number" and value:
                     try:
@@ -648,33 +799,36 @@ class DataTableResource:
             
             # CREATE or UPDATE
             if record_id:
-                # UPDATE
-                if self.on_before_update:
-                    data = self.on_before_update(record_id, data)
-                
-                result = self.update_fn(record_id, data)
+                # ===== UPDATE =====
+                ctx = self._build_context(req, record=data, record_id=record_id)
                 
-                if self.on_after_update:
-                    self.on_after_update(result)
+                if self.on_update_hook:
+                    data = await self._call_hook(self.on_update_hook, ctx)
+                    if data is not None:
+                        self.update_fn(record_id, data)
+                else:
+                    self.update_fn(record_id, data)
                 
                 return self._success_toast("Record updated successfully.")
             else:
-                # CREATE
-                if self.on_before_create:
-                    data = self.on_before_create(data)
-                
+                # ===== CREATE =====
                 # Generate ID if needed
-                if self.id_generator:
+                if self.id_generator and self.row_id_field not in data:
                     data[self.row_id_field] = self.id_generator()
                 
-                result = self.create_fn(data)
+                ctx = self._build_context(req, record=data, record_id=None)
                 
-                if self.on_after_create:
-                    self.on_after_create(result)
+                if self.on_create_hook:
+                    data = await self._call_hook(self.on_create_hook, ctx)
+                    if data is not None:
+                        self.create_fn(data)
+                else:
+                    self.create_fn(data)
                 
                 return self._success_toast("Record created successfully.")
         
         except Exception as e:
+            logger.error(f"Save failed: {e}", exc_info=True)
             return self._error_toast(f"Save failed: {str(e)}")
     
     def _wrap_modal(self, modal):
@@ -684,7 +838,7 @@ class DataTableResource:
         return Div(modal, id=self.feedback_id)
     
     def _success_toast(self, message: str):
-        """Return a success toast in the feedback div."""
+        """✅ Return a success toast with auto-refresh trigger."""
         toast = Toast(
             message,
             variant="success",
@@ -698,10 +852,16 @@ class DataTableResource:
             ),
             active=True
         )
-        return Div(toast, id=self.feedback_id)
+        
+        # Return as HTMLResponse with HX-Trigger for auto-refresh
+        from fasthtml.common import to_xml
+        html_content = to_xml(Div(toast, id=self.feedback_id))
+        response = HTMLResponse(content=html_content)
+        response.headers['HX-Trigger'] = self.refresh_trigger
+        return response
     
     def _error_toast(self, message: str):
-        """Return an error toast in the feedback div."""
+        """❌ Return an error toast (no auto-refresh on errors)."""
         toast = Toast(
             message,
             variant="error",

fh_matui-0.9.5.dist-info/METADATA

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: fh-matui
+Version: 0.9.5
+Summary: material-ui for fasthtml
+Home-page: https://github.com/abhisheksreesaila/fh-matui
+Author: abhishek sreesaila
+Author-email: abhishek.sreesaila@gmail.com
+License: Apache Software License 2.0
+Keywords: nbdev jupyter notebook python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+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
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# fh-matui
+
+
+<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->
+
+## What is fh-matui?
+
+**fh-matui** is a Python library that brings Google’s Material Design to
+[FastHTML](https://fastht.ml/) applications. It provides a comprehensive
+set of pre-built UI components that integrate seamlessly with FastHTML’s
+hypermedia-driven architecture.
+
+Built on top of [BeerCSS](https://www.beercss.com/) (a lightweight
+Material Design 3 CSS framework), fh-matui enables you to create modern,
+responsive web interfaces entirely in Python — no JavaScript required.
+
+## ✨ Key Features
+
+| Feature | Description |
+|----|----|
+| 🎨 **Material Design 3** | Modern, beautiful components following Google’s latest design language |
+| ⚡ **Zero JavaScript** | Build interactive UIs entirely in Python with FastHTML |
+| 📱 **Responsive** | Mobile-first design with automatic breakpoint handling |
+| 🌙 **Dark Mode** | Built-in light/dark theme support with 20+ color schemes |
+| 🧩 **Composable** | Chainable styling APIs inspired by MonsterUI |
+| 📊 **Data Tables** | Full-featured tables with pagination, search, sorting, and CRUD |
+| 🔧 **nbdev-powered** | Literate programming with documentation built from notebooks |
+
+## 🏗️ Architecture
+
+    ┌─────────────────────────────────────────────────────────────┐
+    │                        fh-matui                              │
+    ├─────────────────────────────────────────────────────────────┤
+    │  Foundations     │  Core styling utilities, helpers, enums  │
+    │  Core            │  Theme system, MatTheme color presets    │
+    │  Components      │  Buttons, Cards, Modals, Forms, Tables   │
+    │  App Pages       │  Full-page layouts, navigation patterns  │
+    │  Data Tables     │  DataTable, DataTableResource for CRUD   │
+    │  Web Pages       │  Landing pages, marketing components     │
+    ├─────────────────────────────────────────────────────────────┤
+    │  BeerCSS         │  Material Design 3 CSS framework         │
+    │  FastHTML        │  Python hypermedia web framework         │
+    └─────────────────────────────────────────────────────────────┘
+
+## 🎨 Available Themes
+
+fh-matui includes 15+ pre-configured Material Design 3 color themes:
+
+| Theme                 | Preview | Theme                 | Preview |
+|-----------------------|---------|-----------------------|---------|
+| `MatTheme.red`        | 🔴      | `MatTheme.pink`       | 🩷      |
+| `MatTheme.purple`     | 🟣      | `MatTheme.deepPurple` | 💜      |
+| `MatTheme.indigo`     | 🔵      | `MatTheme.blue`       | 💙      |
+| `MatTheme.lightBlue`  | 🩵      | `MatTheme.cyan`       | 🌊      |
+| `MatTheme.teal`       | 🩶      | `MatTheme.green`      | 💚      |
+| `MatTheme.lightGreen` | 🍀      | `MatTheme.lime`       | 💛      |
+| `MatTheme.yellow`     | 🌟      | `MatTheme.amber`      | 🧡      |
+| `MatTheme.orange`     | 🟠      | `MatTheme.deepOrange` | 🔶      |
+
+**Usage:**
+
+``` python
+# Choose your theme
+app, rt = fast_app(hdrs=[MatTheme.deepPurple.headers()])
+```
+
+## 🚀 Quick Start
+
+Here’s a minimal example to get you started:
+
+``` python
+from fasthtml.common import *
+from fh_matui.core import MatTheme
+from fh_matui.components import Button, Card, FormField
+
+# Create a themed FastHTML app
+app, rt = fast_app(hdrs=[MatTheme.indigo.headers()])
+
+@rt('/')
+def home():
+    return Div(
+        Card(
+            H3("Welcome to fh-matui!"),
+            P("Build beautiful Material Design apps with Python."),
+            FormField("email", label="Email", type="email"),
+            Button("Get Started", cls="primary"),
+        ),
+        cls="padding"
+    )
+
+serve()
+```
+
+## 📦 Installation
+
+``` bash
+pip install fh-matui
+```
+
+### Dependencies
+
+fh-matui automatically includes: - **python-fasthtml** - The core
+FastHTML framework - **BeerCSS** - Loaded via CDN for Material Design 3
+styling
+
+### What This Code Does
+
+1.  **`MatTheme.indigo.headers()`** - Loads BeerCSS with the indigo
+    color scheme
+2.  **[`Card`](https://abhisheksreesaila.github.io/fh-matui/components.html#card)** -
+    Creates a Material Design card component with elevation
+3.  **[`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield)** -
+    Generates a styled input with floating label
+4.  **`Button`** - Renders a Material Design button with ripple effects
+
+## 📚 Module Reference
+
+| 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/datatable.html#datatable), [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatableresource), CRUD operations |
+| [Web Pages](web_pages.html) | Marketing/landing pages | Hero sections, feature grids, testimonials |
+
+## 🛠️ Development
+
+### Install in Development Mode
+
+``` bash
+# Clone the repository
+git clone https://github.com/user/fh-matui.git
+cd fh-matui
+
+# Install in editable mode
+pip install -e .
+
+# Make changes under nbs/ directory, then compile
+nbdev_prepare
+```
+
+## 🤝 Why fh-matui?
+
+| Challenge | fh-matui Solution |
+|----|----|
+| **CSS complexity** | Pre-built Material Design 3 components via BeerCSS |
+| **JavaScript fatigue** | FastHTML handles interactivity declaratively |
+| **Component consistency** | Unified API across all components |
+| **Dark mode support** | Built-in with automatic system preference detection |
+| **Responsive design** | Mobile-first grid system and responsive utilities |
+| **Form handling** | [`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield), [`FormGrid`](https://abhisheksreesaila.github.io/fh-matui/components.html#formgrid), [`FormModal`](https://abhisheksreesaila.github.io/fh-matui/components.html#formmodal) for rapid form building |
+| **Data management** | [`DataTable`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatable) and [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/datatable.html#datatableresource) for CRUD operations |
+
+## 🤖 For LLM Users
+
+fh-matui includes **comprehensive documentation bundles** for Large
+Language Models, enabling AI assistants (like Claude, ChatGPT, or GitHub
+Copilot) to help you build FastHTML apps with complete knowledge of the
+component APIs.
+
+### 📥 Download Context File
+
+**[📄
+llms-ctx.txt](https://raw.githubusercontent.com/abhisheksreesaila/fh-matui/main/llms-ctx.txt)**
+— Complete API documentation in LLM-optimized format
+
+### 💡 How to Use
+
+1.  **Download the context file** from the link above
+2.  **Attach it to your LLM conversation** (drag & drop or paste
+    contents)
+3.  **Ask for implementation** using natural language
+
+**Example Prompt:**
+
+    I'm using fh-matui (context attached). Create a dashboard with:
+    - A sidebar navigation with 5 menu items
+    - A DataTable showing products with pagination
+    - A modal form to add/edit products
+    - Use the deep purple theme
+
+The LLM will generate production-ready FastHTML code using the exact
+component APIs from the documentation.
+
+### 🔄 Staying Up to Date
+
+The `llms-ctx.txt` file is automatically regenerated with each release
+to ensure it stays synchronized with the latest API changes. Always
+download the version matching your installed package version for the
+most accurate results.
+
+> **📌 Note:** The context file is generated from the same literate
+> programming notebooks that build the library itself, ensuring 100%
+> accuracy with the actual implementation.
+
+## 📄 License
+
+This project is licensed under the Apache 2.0 License - see the
+[LICENSE](https://github.com/user/fh-matui/blob/main/LICENSE) file for
+details.
+
+------------------------------------------------------------------------
+
+**Built with ❤️ using FastHTML and nbdev**

{fh_matui-0.9.4.dist-info → fh_matui-0.9.5.dist-info}/RECORD

@@ -1,14 +1,14 @@
 fh_matui/__init__.py,sha256=iPcoATf7BiWjSu-KocRdM5zFTR4wx4ktCHlGGpvdc1M,23
-fh_matui/_modidx.py,sha256=hLZ_V7aRsAvavJ82m02XyvImfzYB5_DnOce8eKRD3xU,22865
+fh_matui/_modidx.py,sha256=RTGErPb_KBkO8z8KjcFH3rczKntoTLkHKAK-4a0oax0,23511
 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/datatable.py,sha256=DsK73GhB18s7KRk5n_2QU54AuRtfFGTckIVOQ_a8n1w,31632
 fh_matui/foundations.py,sha256=b7PnObJpKN8ZAU9NzCm9xpfnHzFjjAROU7E2YvA_tj4,1820
 fh_matui/web_pages.py,sha256=4mF-jpfVcZTVepfQ-aMGgIUp-nBp0YCkvcdsWhUYeaA,34879
-fh_matui-0.9.4.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
-fh_matui-0.9.4.dist-info/METADATA,sha256=CBK48Mce-W9Lgll_Pj6XvYGDG_GFkqVor8aCqwI84fk,8369
-fh_matui-0.9.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fh_matui-0.9.4.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
-fh_matui-0.9.4.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
-fh_matui-0.9.4.dist-info/RECORD,,
+fh_matui-0.9.5.dist-info/licenses/LICENSE,sha256=xV8xoN4VOL0uw9X8RSs2IMuD_Ss_a9yAbtGNeBWZwnw,11337
+fh_matui-0.9.5.dist-info/METADATA,sha256=dUxJJcfK4MX0RbEdlchOVr2KbHPmn03NVm-nUvlgdcE,10490
+fh_matui-0.9.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fh_matui-0.9.5.dist-info/entry_points.txt,sha256=zn4CR4gNTiAAxbFsCxHAf2tQhtW29_YOffjbUTgeoWI,38
+fh_matui-0.9.5.dist-info/top_level.txt,sha256=l80d5eoA2ZjqtPYwAorLMS5PiHxUxz3zKzxMJ41Xoso,9
+fh_matui-0.9.5.dist-info/RECORD,,

fh_matui-0.9.4.dist-info/METADATA

@@ -1,187 +0,0 @@
-Metadata-Version: 2.4
-Name: fh-matui
-Version: 0.9.4
-Summary: material-ui for fasthtml
-Home-page: https://github.com/abhisheksreesaila/fh-matui
-Author: abhishek sreesaila
-Author-email: abhishek.sreesaila@gmail.com
-License: Apache Software License 2.0
-Keywords: nbdev jupyter notebook python
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-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
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-
-## What is fh-matui?
-
-**fh-matui** is a Python library that brings Google's Material Design to [FastHTML](https://fastht.ml/) applications. It provides a comprehensive set of pre-built UI components that integrate seamlessly with FastHTML's hypermedia-driven architecture.
-
-Built on top of [BeerCSS](https://www.beercss.com/) (a lightweight Material Design 3 CSS framework), fh-matui enables you to create modern, responsive web interfaces entirely in Python — no JavaScript required.
-
-## ✨ Key Features
-
-| Feature | Description |
-|---------|-------------|
-| 🎨 **Material Design 3** | Modern, beautiful components following Google's latest design language |
-| ⚡ **Zero JavaScript** | Build interactive UIs entirely in Python with FastHTML |
-| 📱 **Responsive** | Mobile-first design with automatic breakpoint handling |
-| 🌙 **Dark Mode** | Built-in light/dark theme support with 20+ color schemes |
-| 🧩 **Composable** | Chainable styling APIs inspired by MonsterUI |
-| 📊 **Data Tables** | Full-featured tables with pagination, search, sorting, and CRUD |
-| 🔧 **nbdev-powered** | Literate programming with documentation built from notebooks |
-
-## 🏗️ Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        fh-matui                              │
-├─────────────────────────────────────────────────────────────┤
-│  Foundations     │  Core styling utilities, helpers, enums  │
-│  Core            │  Theme system, MatTheme color presets    │
-│  Components      │  Buttons, Cards, Modals, Forms, Tables   │
-│  App Pages       │  Full-page layouts, navigation patterns  │
-│  Data Tables     │  DataTable, DataTableResource for CRUD   │
-│  Web Pages       │  Landing pages, marketing components     │
-├─────────────────────────────────────────────────────────────┤
-│  BeerCSS         │  Material Design 3 CSS framework         │
-│  FastHTML        │  Python hypermedia web framework         │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## 🎨 Available Themes
-
-fh-matui includes 15+ pre-configured Material Design 3 color themes:
-
-| Theme | Preview | Theme | Preview |
-|-------|---------|-------|---------|
-| `MatTheme.red` | 🔴 | `MatTheme.pink` | 🩷 |
-| `MatTheme.purple` | 🟣 | `MatTheme.deepPurple` | 💜 |
-| `MatTheme.indigo` | 🔵 | `MatTheme.blue` | 💙 |
-| `MatTheme.lightBlue` | 🩵 | `MatTheme.cyan` | 🌊 |
-| `MatTheme.teal` | 🩶 | `MatTheme.green` | 💚 |
-| `MatTheme.lightGreen` | 🍀 | `MatTheme.lime` | 💛 |
-| `MatTheme.yellow` | 🌟 | `MatTheme.amber` | 🧡 |
-| `MatTheme.orange` | 🟠 | `MatTheme.deepOrange` | 🔶 |
-
-**Usage:**
-```python
-# Choose your theme
-app, rt = fast_app(hdrs=[MatTheme.deepPurple.headers()])
-```
-
-## 🚀 Quick Start
-
-Here's a minimal example to get you started:
-
-```python
-from fasthtml.common import *
-from fh_matui.core import MatTheme
-from fh_matui.components import Button, Card, FormField
-
-# Create a themed FastHTML app
-app, rt = fast_app(hdrs=[MatTheme.indigo.headers()])
-
-@rt('/')
-def home():
-    return Div(
-        Card(
-            H3("Welcome to fh-matui!"),
-            P("Build beautiful Material Design apps with Python."),
-            Button("Get Started", cls="primary"),
-        ),
-        cls="padding"
-    )
-
-serve()
-```
-
-## 📦 Installation
-
-```bash
-pip install fh-matui
-```
-
-### Dependencies
-
-fh-matui automatically includes:
-- **python-fasthtml** - The core FastHTML framework
-- **BeerCSS** - Loaded via CDN for Material Design 3 styling
-
-### What This Code Does
-
-1. **`MatTheme.indigo.headers()`** - Loads BeerCSS with the indigo color scheme
-2. **[`Card`](https://abhisheksreesaila.github.io/fh-matui/components.html#card)** - Creates a Material Design card component with elevation
-3. **[`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield)** - Generates a styled input with floating label
-4. **`Button`** - Renders a Material Design button with ripple effects
-
-## 📚 Module Reference
-
-| Module | Description | Key Components |
-|--------|-------------|----------------|
-| [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
-
-### Install in Development Mode
-
-```bash
-# Clone the repository
-git clone https://github.com/user/fh-matui.git
-cd fh-matui
-
-# Install in editable mode
-pip install -e .
-
-# Make changes under nbs/ directory, then compile
-nbdev_prepare
-```
-
-## 🤝 Why fh-matui?
-
-| Challenge | fh-matui Solution |
-|-----------|-------------------|
-| **CSS complexity** | Pre-built Material Design 3 components via BeerCSS |
-| **JavaScript fatigue** | FastHTML handles interactivity declaratively |
-| **Component consistency** | Unified API across all components |
-| **Dark mode support** | Built-in with automatic system preference detection |
-| **Responsive design** | Mobile-first grid system and responsive utilities |
-| **Form handling** | [`FormField`](https://abhisheksreesaila.github.io/fh-matui/components.html#formfield), [`FormGrid`](https://abhisheksreesaila.github.io/fh-matui/components.html#formgrid), [`FormModal`](https://abhisheksreesaila.github.io/fh-matui/components.html#formmodal) for rapid form building |
-| **Data management** | [`DataTable`](https://abhisheksreesaila.github.io/fh-matui/table.html#datatable) and [`DataTableResource`](https://abhisheksreesaila.github.io/fh-matui/table.html#datatableresource) for CRUD operations |
-
-## 📄 License
-
-This project is licensed under the Apache 2.0 License - see the [LICENSE](https://github.com/user/fh-matui/blob/main/LICENSE) file for details.
-
----
-
-**Built with ❤️ using FastHTML and nbdev**