eidosui 0.1.0__tar.gz → 0.3.0__tar.gz

{eidosui-0.1.0 → eidosui-0.3.0}/.gitignore

@@ -2,7 +2,7 @@
 __pycache__/
 *.py[cod]
 *$py.class
-
+.specstory/**
 # C extensions
 *.so
 

eidosui-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Feldroy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eidosui-0.3.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: eidosui
+Version: 0.3.0
+Summary: A modern, Tailwind CSS-based UI library for air development
+Project-URL: Homepage, https://github.com/isaac-flath/EidosUI
+Project-URL: Repository, https://github.com/isaac-flath/EidosUI
+Project-URL: Issues, https://github.com/isaac-flath/EidosUI/issues
+Project-URL: Documentation, https://github.com/isaac-flath/EidosUI#readme
+Author: Isaac Flath
+License-Expression: MIT
+License-File: LICENSE
+Keywords: air,components,css,fastapi,tailwind,ui,web
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: air>=0.12
+Requires-Dist: fastapi[standard]
+Requires-Dist: uvicorn
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: isort; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: markdown
+Requires-Dist: markdown>=3.4; extra == 'markdown'
+Description-Content-Type: text/markdown
+
+# EidosUI 🎨
+
+A modern, flexible Tailwind CSS-based UI library for Python web frameworks. Built for maximum developer flexibility while providing excellent defaults.
+
+> [!CAUTION]
+> This library is not ready for anything yet.  IN fact, this readme is more of design ideas than anything as much of what's in here isn't implemented yet!
+
+
+## Design
+
+### Base CSS
+
+- `styles.css` : defines all the core css logic to create classes like `edios-mark`, `eidos-small`, etc.
+- `light.css`/`dark.css` : These define lots of css variables used in `styles.css` and are themes
+
+Users would create a custom theme by copying light/dark css files and changing the variable definitions.
+
+### Styles
+
+This has enums that make the Base CSS clases accessible in python.  For example:
+
+`styles.typography.h1` or `styles.buttons.primary`
+
+### Tags
+
+```python
+def H1(*content, cls: str = None, **kwargs) -> air.H1:
+    """Semantic H1 heading"""
+    return air.H1(*content, cls=stringify(styles.typography.h1, cls), **kwargs)
+
+def Mark(*content, cls: str = None, **kwargs) -> air.Mark:
+    """Highlighted text"""
+    return .Mark(*content, cls=stringify(styles.typography.mark, cls), **kwargs)
+
+def Small(*content, cls: str = , **kwargs) -> air.Small:
+    """Small text"""
+    return air.Small(*content, cls=stringify(styles.typography.small, cls), **kwargs) 
+```
+
+### Components (Not Built Yet)
+
+Theses are things that go beyond just exposing css to python.  Here's a simple example of what might be added.
+
+```python
+class Table:
+    def __init__(self, cls: str = None, **kwargs):
+        """Create an empty table with optional styling"""
+        self.cls = cls
+        self.kwargs = kwargs
+    
+    @classmethod
+    def from_lists(cls, data: list[list], headers: list[str] = None, cls_: str = None, **kwargs):
+        """Create table from list of lists"""
+        thead = []
+        if headers:
+            thead = THead(Tr(*[Th(header) for header in headers]))
+        
+        tbody_rows = []
+        for data in row_data:
+            tbody_rows.append(Tr(*map(Td, row_data)))
+        tbody = TBody(*tbody_rows)
+        
+        return Table(thead+tbody, cls=cls_, **kwargs)
+    
+    @classmethod
+    def from_dicts(cls, data: list[dict], headers: list[str] = None, cls_: str = None, **kwargs):
+        """Create table from list of dictionaries"""
+        thead = []
+        if headers:
+            thead = THead(Tr(*[Th(header) for header in headers]))
+        
+        tbody_rows = []
+        for row in data:
+            tbody_rows.append(Tr(*[Td(row.get(header, "")) for header in (headers or list(row.keys()))]))
+        tbody = TBody(*tbody_rows)
+        
+        return Table(thead+tbody, cls=cls_, **kwargs)
+
+# Usage examples:
+Table.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+Table.from_dicts([{"name": "John", "age": 25}], headers=["Name", "Age"])
+```
+
+## Plugins
+
+### edios-md
+
+This will be installable with `pip install "eidos[markdown]"`. 
+
+This is a plugin for rendering markdown that is well scoped to just markdown rendering.  This module does markdown rendering well with table of contents with scrollspy, code highlighting, latex rendering, etc.  It must be used with `EidosUI` as it uses css variables from there for the styling (so it is always in sync with the theme)
+

eidosui-0.3.0/README.md

@@ -0,0 +1,91 @@
+# EidosUI 🎨
+
+A modern, flexible Tailwind CSS-based UI library for Python web frameworks. Built for maximum developer flexibility while providing excellent defaults.
+
+> [!CAUTION]
+> This library is not ready for anything yet.  IN fact, this readme is more of design ideas than anything as much of what's in here isn't implemented yet!
+
+
+## Design
+
+### Base CSS
+
+- `styles.css` : defines all the core css logic to create classes like `edios-mark`, `eidos-small`, etc.
+- `light.css`/`dark.css` : These define lots of css variables used in `styles.css` and are themes
+
+Users would create a custom theme by copying light/dark css files and changing the variable definitions.
+
+### Styles
+
+This has enums that make the Base CSS clases accessible in python.  For example:
+
+`styles.typography.h1` or `styles.buttons.primary`
+
+### Tags
+
+```python
+def H1(*content, cls: str = None, **kwargs) -> air.H1:
+    """Semantic H1 heading"""
+    return air.H1(*content, cls=stringify(styles.typography.h1, cls), **kwargs)
+
+def Mark(*content, cls: str = None, **kwargs) -> air.Mark:
+    """Highlighted text"""
+    return .Mark(*content, cls=stringify(styles.typography.mark, cls), **kwargs)
+
+def Small(*content, cls: str = , **kwargs) -> air.Small:
+    """Small text"""
+    return air.Small(*content, cls=stringify(styles.typography.small, cls), **kwargs) 
+```
+
+### Components (Not Built Yet)
+
+Theses are things that go beyond just exposing css to python.  Here's a simple example of what might be added.
+
+```python
+class Table:
+    def __init__(self, cls: str = None, **kwargs):
+        """Create an empty table with optional styling"""
+        self.cls = cls
+        self.kwargs = kwargs
+    
+    @classmethod
+    def from_lists(cls, data: list[list], headers: list[str] = None, cls_: str = None, **kwargs):
+        """Create table from list of lists"""
+        thead = []
+        if headers:
+            thead = THead(Tr(*[Th(header) for header in headers]))
+        
+        tbody_rows = []
+        for data in row_data:
+            tbody_rows.append(Tr(*map(Td, row_data)))
+        tbody = TBody(*tbody_rows)
+        
+        return Table(thead+tbody, cls=cls_, **kwargs)
+    
+    @classmethod
+    def from_dicts(cls, data: list[dict], headers: list[str] = None, cls_: str = None, **kwargs):
+        """Create table from list of dictionaries"""
+        thead = []
+        if headers:
+            thead = THead(Tr(*[Th(header) for header in headers]))
+        
+        tbody_rows = []
+        for row in data:
+            tbody_rows.append(Tr(*[Td(row.get(header, "")) for header in (headers or list(row.keys()))]))
+        tbody = TBody(*tbody_rows)
+        
+        return Table(thead+tbody, cls=cls_, **kwargs)
+
+# Usage examples:
+Table.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+Table.from_dicts([{"name": "John", "age": 25}], headers=["Name", "Age"])
+```
+
+## Plugins
+
+### edios-md
+
+This will be installable with `pip install "eidos[markdown]"`. 
+
+This is a plugin for rendering markdown that is well scoped to just markdown rendering.  This module does markdown rendering well with table of contents with scrollspy, code highlighting, latex rendering, etc.  It must be used with `EidosUI` as it uses css variables from there for the styling (so it is always in sync with the theme)
+

eidosui-0.3.0/eidos/components/headers.py

@@ -0,0 +1,68 @@
+from air import Meta, Script, Link
+from ..tags import Body
+from typing import Literal
+
+def get_css_urls():
+    """Return list of CSS URLs for EidosUI."""
+    return [
+        "/eidos/css/styles.css",
+        "/eidos/css/themes/eidos-variables.css", 
+        "/eidos/css/themes/light.css",
+        "/eidos/css/themes/dark.css"
+    ]
+
+def EidosHeaders(
+    include_tailwind: bool = True,
+    include_lucide: bool = True,
+    include_eidos_js: bool = True,
+    theme: Literal["light", "dark"] = "light",
+):
+    """Complete EidosUI headers with EidosUI JavaScript support.
+    
+    Args:
+        include_tailwind: Include Tailwind CSS CDN
+        include_lucide: Include Lucide Icons CDN
+        include_eidos_js: Include EidosUI JavaScript (navigation, future features)
+        theme: Initial theme
+    """
+    headers = [
+        Meta(charset="UTF-8"),
+        Meta(name="viewport", content="width=device-width, initial-scale=1.0"),
+    ]
+    
+    # Core libraries
+    if include_tailwind:
+        headers.append(Script(src="https://cdn.tailwindcss.com"))
+    
+    if include_lucide:
+        headers.append(Script(src="https://unpkg.com/lucide@latest/dist/umd/lucide.js"))
+    
+    # EidosUI CSS
+    for css_url in get_css_urls():
+        headers.append(Link(rel="stylesheet", href=css_url))
+    
+    # EidosUI JavaScript
+    if include_eidos_js:
+        headers.append(Script(src="/eidos/js/eidos.js", defer=True))
+    
+    # Initialization script
+    init_script = f"""
+        // Set theme
+        document.documentElement.setAttribute('data-theme', '{theme}');
+    """
+    
+    if include_lucide:
+        init_script += """
+        // Initialize Lucide icons
+        if (document.readyState === 'loading') {
+            document.addEventListener('DOMContentLoaded', () => {
+                if (window.lucide) lucide.createIcons();
+            });
+        } else {
+            if (window.lucide) lucide.createIcons();
+        }
+    """
+    
+    headers.append(Script(init_script))
+    
+    return headers

eidosui-0.3.0/eidos/components/navigation.py

@@ -0,0 +1,78 @@
+from air import Div, A, I, Tag
+from ..tags import *
+from ..utils import stringify
+from typing import Final, Optional, Any, Union
+from uuid import uuid4
+
+class ScrollspyT:
+    underline: Final[str] = 'navbar-underline'
+    bold: Final[str] = 'navbar-bold'
+
+def NavBar(*c: Any,
+           lcontents: Tag = H3("Title"),
+           right_cls: str = 'items-center space-x-4',
+           mobile_cls: str = '',
+           sticky: bool = False,
+           scrollspy: bool = False,
+           cls: str = 'p-4',
+           scrollspy_cls: str = ScrollspyT.underline,
+           menu_id: Optional[str] = None,
+           ) -> Tag:
+    """Pure Tailwind responsive navigation bar with optional scrollspy.
+    
+    Mobile menu uses best practice dropdown with:
+    - Centered text links
+    - Large touch targets
+    - Auto-close on selection
+    - Smooth animations
+    """
+    if menu_id is None: menu_id = f"menu-{uuid4().hex[:8]}"
+    
+    sticky_cls = 'sticky top-0 eidos-navbar-sticky z-50' if sticky else ''
+    
+    # Mobile toggle button with hamburger/close icon
+    mobile_icon = A(
+        I(data_lucide="menu", class_="w-6 h-6", data_menu_icon="open"),
+        I(data_lucide="x", class_="w-6 h-6 hidden", data_menu_icon="close"),
+        class_="md:hidden cursor-pointer p-2 eidos-navbar-toggle rounded-lg transition-colors",
+        data_toggle=f"#{menu_id}",
+        role="button",
+        aria_label="Toggle navigation",
+        aria_expanded="false"
+    )
+    
+    # Desktop navigation
+    desktop_nav = Div(
+        *c,
+        class_=stringify(right_cls, 'hidden md:flex'),
+        data_scrollspy="true" if scrollspy else None
+    )
+    
+    # Mobile navigation
+    mobile_nav = Div(
+        *c,
+        class_=stringify(
+            mobile_cls, 
+            'hidden md:hidden absolute top-full left-0 right-0 eidos-navbar-mobile shadow-lg border-t',
+            'flex flex-col eidos-navbar-mobile-divider' if not mobile_cls else '',
+            scrollspy_cls
+        ),
+        id=menu_id,
+        data_scrollspy="true" if scrollspy else None,
+        data_mobile_menu="true"
+    )
+    
+    return Div(
+        # Main navbar container with relative positioning for mobile dropdown
+        Div(
+            Div(
+                lcontents,
+                mobile_icon,
+                desktop_nav,
+                class_='flex items-center justify-between'
+            ),
+            mobile_nav,
+            class_=stringify('eidos-navbar relative', cls, scrollspy_cls)
+        ),
+        class_=sticky_cls
+    )