fh-matui 0.9.4__tar.gz → 0.9.6__tar.gz

fh_matui-0.9.6/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: fh-matui
+Version: 0.9.6
+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.6/README.md

@@ -0,0 +1,205 @@
+# 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.6/fh_matui/__init__.py

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

{fh_matui-0.9.4 → fh_matui-0.9.6}/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',
@@ -152,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'),