eidosui 0.3.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

eidos/__init__.py

@@ -0,0 +1,270 @@
+"""EidosUI - A modern, flexible Tailwind CSS-based UI library for Python web frameworks.
+
+Quick start:
+    >>> from eidos import *
+    >>> DataTable.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+
+Or use explicit imports:
+    >>> from eidos import DataTable, Button, H1, Table
+    >>> from eidos import styles
+"""
+
+# Import all styled HTML tags
+# Import style namespaces
+from . import styles
+
+# Import components
+from .components import DataTable, EidosHeaders, NavBar
+from .styles import buttons, semantic, tables, typography
+from .tags import (
+    # Headings
+    H1,
+    H2,
+    H3,
+    H4,
+    H5,
+    H6,
+    # Pass-through HTML tags
+    A,
+    Abbr,
+    Address,
+    Area,
+    Article,
+    Aside,
+    Audio,
+    B,
+    Base,
+    Bdi,
+    Bdo,
+    Blockquote,
+    # Body
+    Body,
+    Br,
+    # Buttons
+    Button,
+    Canvas,
+    Caption,
+    Cite,
+    Code,
+    Col,
+    Colgroup,
+    Data,
+    Datalist,
+    Dd,
+    Del,
+    Details,
+    Dfn,
+    Dialog,
+    Div,
+    Dl,
+    Dt,
+    Em,
+    Embed,
+    Fieldset,
+    Figcaption,
+    Figure,
+    Footer,
+    Form,
+    Head,
+    Header,
+    Hgroup,
+    Hr,
+    Html,
+    I,
+    Iframe,
+    Img,
+    Input,
+    Ins,
+    Kbd,
+    Label,
+    Legend,
+    Li,
+    Link,
+    Main,
+    Map,
+    Mark,
+    Menu,
+    Meta,
+    Meter,
+    Nav,
+    Noscript,
+    Object,
+    Ol,
+    Optgroup,
+    Option,
+    Output,
+    P,
+    Param,
+    Picture,
+    Pre,
+    Progress,
+    Q,
+    Rp,
+    Rt,
+    Ruby,
+    S,
+    Samp,
+    Script,
+    Search,
+    Section,
+    Select,
+    Small,
+    Source,
+    Span,
+    # Semantic typography
+    Strong,
+    Style,
+    Sub,
+    Summary,
+    Sup,
+    # Table elements
+    Table,
+    Tbody,
+    Td,
+    Template,
+    Textarea,
+    Tfoot,
+    Th,
+    Thead,
+    Time,
+    Title,
+    Tr,
+    Track,
+    U,
+    Ul,
+    Var,
+    Video,
+    Wbr,
+)
+
+# Version info
+__version__ = "0.4.0"
+
+# Define what's available with "from eidos import *"
+__all__ = [
+    # Version
+    "__version__",
+    # Style namespaces
+    "styles",
+    "buttons",
+    "typography",
+    "semantic",
+    "tables",
+    # Components
+    "DataTable",
+    "NavBar",
+    "EidosHeaders",
+    # HTML Tags
+    "H1",
+    "H2",
+    "H3",
+    "H4",
+    "H5",
+    "H6",
+    "Body",
+    "Button",
+    "Strong",
+    "I",
+    "Small",
+    "Del",
+    "Abbr",
+    "Var",
+    "Mark",
+    "Time",
+    "Code",
+    "Pre",
+    "Kbd",
+    "Samp",
+    "Blockquote",
+    "Cite",
+    "Address",
+    "Hr",
+    "Details",
+    "Summary",
+    "Dl",
+    "Dt",
+    "Dd",
+    "Figure",
+    "Figcaption",
+    "Table",
+    "Thead",
+    "Tbody",
+    "Tfoot",
+    "Tr",
+    "Th",
+    "Td",
+    "A",
+    "Area",
+    "Article",
+    "Aside",
+    "Audio",
+    "B",
+    "Base",
+    "Bdi",
+    "Bdo",
+    "Br",
+    "Canvas",
+    "Caption",
+    "Col",
+    "Colgroup",
+    "Data",
+    "Datalist",
+    "Dfn",
+    "Dialog",
+    "Div",
+    "Em",
+    "Embed",
+    "Fieldset",
+    "Footer",
+    "Form",
+    "Head",
+    "Header",
+    "Hgroup",
+    "Html",
+    "Iframe",
+    "Img",
+    "Input",
+    "Ins",
+    "Label",
+    "Legend",
+    "Li",
+    "Link",
+    "Main",
+    "Map",
+    "Menu",
+    "Meta",
+    "Meter",
+    "Nav",
+    "Noscript",
+    "Object",
+    "Ol",
+    "Optgroup",
+    "Option",
+    "Output",
+    "P",
+    "Param",
+    "Picture",
+    "Progress",
+    "Q",
+    "Rp",
+    "Rt",
+    "Ruby",
+    "S",
+    "Script",
+    "Search",
+    "Section",
+    "Select",
+    "Source",
+    "Span",
+    "Style",
+    "Sub",
+    "Sup",
+    "Template",
+    "Textarea",
+    "Title",
+    "Track",
+    "U",
+    "Ul",
+    "Video",
+    "Wbr",
+]

eidos/components/__init__.py

@@ -0,0 +1,10 @@
+"""EidosUI Components Package
+
+Higher-level components built on top of the base tags.
+"""
+
+from .headers import EidosHeaders
+from .navigation import NavBar
+from .table import DataTable
+
+__all__ = ["DataTable", "NavBar", "EidosHeaders"]

eidos/components/headers.py

@@ -1,16 +1,18 @@
-from air import Meta, Script, Link
-from ..tags import Body
 from typing import Literal
 
+from air import Link, Meta, Script
+
+
 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/eidos-variables.css",
         "/eidos/css/themes/light.css",
-        "/eidos/css/themes/dark.css"
+        "/eidos/css/themes/dark.css",
     ]
 
+
 def EidosHeaders(
     include_tailwind: bool = True,
     include_lucide: bool = True,
@@ -18,7 +20,7 @@ def EidosHeaders(
     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
@@ -29,28 +31,28 @@ def EidosHeaders(
         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
@@ -62,7 +64,7 @@ def EidosHeaders(
             if (window.lucide) lucide.createIcons();
         }
     """
-    
+
     headers.append(Script(init_script))
-    
-    return headers
+
+    return headers

eidos/components/navigation.py

@@ -1,35 +1,44 @@
-from air import Div, A, I, Tag
+from typing import Any, Final
+from uuid import uuid4
+
+from air import A, Div, 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'
+    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:
+def NavBar(
+    *c: Any,
+    lcontents: Tag | None = None,
+    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: str | None = 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 ''
-    
+    if lcontents is None:
+        lcontents = Div()
+
+    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"),
@@ -38,30 +47,30 @@ def NavBar(*c: Any,
         data_toggle=f"#{menu_id}",
         role="button",
         aria_label="Toggle navigation",
-        aria_expanded="false"
+        aria_expanded="false",
     )
-    
+
     # Desktop navigation
     desktop_nav = Div(
         *c,
-        class_=stringify(right_cls, 'hidden md:flex'),
-        data_scrollspy="true" if scrollspy else None
+        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
+            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"
+        data_mobile_menu="true",
     )
-    
+
     return Div(
         # Main navbar container with relative positioning for mobile dropdown
         Div(
@@ -69,10 +78,10 @@ def NavBar(*c: Any,
                 lcontents,
                 mobile_icon,
                 desktop_nav,
-                class_='flex items-center justify-between'
+                class_="flex items-center justify-between",
             ),
             mobile_nav,
-            class_=stringify('eidos-navbar relative', cls, scrollspy_cls)
+            class_=stringify("eidos-navbar relative", cls, scrollspy_cls),
         ),
-        class_=sticky_cls
-    )
+        class_=sticky_cls,
+    )

eidos/components/table.py

@@ -0,0 +1,84 @@
+from typing import Any
+
+from ..tags import Table as BaseTable
+from ..tags import Tbody, Td, Th, Thead, Tr
+
+
+class DataTable:
+    """DataTable component that provides convenient methods for creating tables from data."""
+
+    @classmethod
+    def from_lists(
+        cls,
+        data: list[list],
+        headers: list[str] | None = None,
+        class_: str | list[str] | None = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Create table from list of lists.
+
+        Args:
+            data: List of lists where each inner list is a row
+            headers: Optional list of header strings
+            class_: Optional CSS classes to add to the table
+            **kwargs: Additional attributes to pass to the table element
+
+        Returns:
+            A rendered table element
+
+        Example:
+            Table.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+        """
+        content = []
+
+        if headers:
+            thead = Thead(Tr(*[Th(header) for header in headers]))
+            content.append(thead)
+
+        tbody_rows = []
+        for row_data in data:
+            tbody_rows.append(Tr(*[Td(cell) for cell in row_data]))
+        tbody = Tbody(*tbody_rows)
+        content.append(tbody)
+
+        return BaseTable(*content, class_=class_, **kwargs)
+
+    @classmethod
+    def from_dicts(
+        cls,
+        data: list[dict],
+        headers: list[str] | None = None,
+        class_: str | list[str] | None = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Create table from list of dictionaries.
+
+        Args:
+            data: List of dictionaries where each dict is a row
+            headers: Optional list of header strings. If not provided, uses keys from first dict
+            class_: Optional CSS classes to add to the table
+            **kwargs: Additional attributes to pass to the table element
+
+        Returns:
+            A rendered table element
+
+        Example:
+            Table.from_dicts([{"name": "John", "age": 25}], headers=["name", "age"])
+        """
+        if headers is None and data:
+            headers = list(data[0].keys())
+
+        content = []
+
+        if headers:
+            thead = Thead(Tr(*[Th(header) for header in headers]))
+            content.append(thead)
+
+        tbody_rows = []
+        if data and headers:
+            for row in data:
+                tbody_rows.append(Tr(*[Td(row.get(key, "")) for key in headers]))
+        tbody = Tbody(*tbody_rows)
+        content.append(tbody)
+
+        return BaseTable(*content, class_=class_, **kwargs)

eidos/css/styles.css

@@ -339,6 +339,54 @@
     margin: var(--space-xl) 0;
 }
 
+/* Table styles */
+.eidos-table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: var(--font-size-base);
+    background-color: var(--color-background);
+}
+
+.eidos-thead {
+    background-color: var(--color-surface);
+    border-bottom: var(--border-2) solid var(--color-border);
+}
+
+.eidos-tbody {
+    background-color: var(--color-background);
+}
+
+.eidos-tfoot {
+    background-color: var(--color-surface);
+    border-top: var(--border-2) solid var(--color-border);
+}
+
+.eidos-tr {
+    border-bottom: var(--border) solid var(--color-border);
+    transition: background-color var(--transition-fast);
+}
+
+.eidos-tbody .eidos-tr:hover {
+    background-color: var(--color-surface);
+}
+
+.eidos-tbody .eidos-tr:last-child {
+    border-bottom: none;
+}
+
+.eidos-th {
+    padding: var(--space-sm) var(--space-md);
+    text-align: left;
+    font-weight: var(--font-weight-semibold);
+    color: var(--color-text);
+}
+
+.eidos-td {
+    padding: var(--space-sm) var(--space-md);
+    text-align: left;
+    color: var(--color-text);
+}
+
 /* Navigation base styles */
 .eidos-navbar {
     width: 100%;

eidos/plugins/__init__.py

@@ -1 +1 @@
-# EidosUI plugins package
+# EidosUI plugins package

eidos/plugins/markdown/__init__.py

@@ -5,10 +5,10 @@ EidosUI themes through CSS variables.
 
 Basic usage:
     from eidos.plugins.markdown import Markdown, MarkdownCSS
-    
+
     # In your document head
     MarkdownCSS()
-    
+
     # In your content
     Markdown("# Hello World\\n\\nThis is **markdown**!")
 """
@@ -18,4 +18,4 @@ from .renderer import MarkdownRenderer
 
 __all__ = ["Markdown", "MarkdownCSS", "MarkdownRenderer"]
 
-__version__ = "0.1.0"
+__version__ = "0.1.0"

eidos/plugins/markdown/components.py

@@ -1,53 +1,41 @@
 """Markdown components for EidosUI"""
 
 import air
-from typing import Optional
-from .renderer import MarkdownRenderer
 
+from .renderer import MarkdownRenderer
 
 # Global renderer instance for reuse
 _renderer = MarkdownRenderer()
 
 
-def Markdown(content: str, class_: Optional[str] = None, **kwargs) -> air.Div:
+def Markdown(content: str, class_: str | None = None, **kwargs) -> air.Div:
     """Main markdown component that renders markdown content with theme integration.
-    
+
     Args:
         content: Markdown text to render
         class_: Additional CSS classes to apply
         **kwargs: Additional attributes to pass to the wrapper div
-        
+
     Returns:
         air.Div containing the rendered markdown HTML
     """
     # Render the markdown content
     html_content = _renderer.render(content)
-    
-    # Create the div with raw HTML content
-    if class_:
-        return air.Div(
-            air.RawHTML(html_content),
-            class_=class_,
-            **kwargs
-        )
-    else:
-        return air.Div(
-            air.RawHTML(html_content),
-            **kwargs
-        )
+
+    return air.Div(air.RawHTML(html_content), class_=class_, **kwargs)
 
 
 def MarkdownCSS() -> air.Link:
     """Returns a link tag to include the markdown CSS.
-    
+
     This should be included in the head of your document to ensure
     markdown styling is available.
-    
+
     Returns:
         air.Link element pointing to the markdown CSS file
     """
     return air.Link(
         rel="stylesheet",
         href="/eidos/plugins/markdown/css/markdown.css",
-        type="text/css"
-    )
+        type="text/css",
+    )