eidosui 0.4.0__py3-none-any.whl → 0.6.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, lists, 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",
+    "lists",
+    "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,11 @@
+"""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
+from .tabs import TabContainer, TabList, TabPanel, Tabs
+
+__all__ = ["DataTable", "NavBar", "EidosHeaders", "TabContainer", "TabList", "TabPanel", "Tabs"]

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/components/tabs.py

@@ -0,0 +1,140 @@
+from air import Button, Div, Tag
+
+from .. import styles
+from ..utils import stringify
+
+
+def TabContainer(
+    initial_tab_url: str,
+    cls: str = "",
+    target_id: str = "tabs",
+) -> Tag:
+    """HTMX-based tab container that loads tabs dynamically.
+    
+    Args:
+        initial_tab_url: URL to load the initial tab content
+        cls: Additional classes for the container
+        target_id: ID for the tab container (default: "tabs")
+        
+    Returns:
+        Tag: The tab container that will be populated via HTMX
+        
+    Example:
+        TabContainer("/settings/general")
+    """
+    return Div(
+        id=target_id,
+        hx_get=initial_tab_url,
+        hx_trigger="load delay:100ms",
+        hx_target=f"#{target_id}",
+        hx_swap="innerHTML",
+        class_=stringify(styles.tabs.container, cls),
+    )
+
+
+def TabList(
+    *tabs: tuple[str, str],
+    selected: int = 0,
+    tab_cls: str = "",
+    hx_target: str = "#tabs",
+    hx_swap: str = "innerHTML",
+) -> Tag:
+    """HTMX-based tab list for server-rendered tabs.
+    
+    Args:
+        *tabs: Variable number of (label, url) tuples
+        selected: Index of the selected tab (0-based)
+        tab_cls: Additional classes for tab buttons
+        hx_target: HTMX target for tab content (default: "#tabs")
+        hx_swap: HTMX swap method (default: "innerHTML")
+        
+    Returns:
+        Tag: The tab list component
+        
+    Example:
+        TabList(
+            ("General", "/settings/general"),
+            ("Security", "/settings/security"),
+            ("Advanced", "/settings/advanced"),
+            selected=0
+        )
+    """
+    tab_buttons = []
+
+    for i, (label, url) in enumerate(tabs):
+        is_selected = i == selected
+
+        tab_button = Button(
+            label,
+            hx_get=url,
+            hx_target=hx_target,
+            hx_swap=hx_swap,
+            role="tab",
+            aria_selected="true" if is_selected else "false",
+            aria_controls="tab-content",
+            class_=stringify(
+                styles.tabs.tab,
+                styles.tabs.tab_active if is_selected else "",
+                tab_cls
+            ),
+        )
+        tab_buttons.append(tab_button)
+
+    return Div(
+        *tab_buttons,
+        role="tablist",
+        class_=styles.tabs.list,
+    )
+
+
+def TabPanel(
+    content: Tag,
+    panel_cls: str = "",
+) -> Tag:
+    """Tab panel content wrapper.
+    
+    Args:
+        content: The content to display in the tab panel
+        panel_cls: Additional classes for the panel
+        
+    Returns:
+        Tag: The tab panel component
+    """
+    return Div(
+        content,
+        id="tab-content",
+        role="tabpanel",
+        class_=stringify(styles.tabs.panel, styles.tabs.panel_active, panel_cls),
+    )
+
+
+def Tabs(
+    tab_list: Tag,
+    tab_panel: Tag,
+    cls: str = "",
+) -> Tag:
+    """Complete tab component with list and panel.
+    
+    Args:
+        tab_list: The TabList component
+        tab_panel: The TabPanel component
+        cls: Additional classes for the container
+        
+    Returns:
+        Tag: The complete tabs component
+        
+    Example:
+        # In your route handler:
+        tab_list = TabList(
+            ("General", "/settings/general"),
+            ("Security", "/settings/security"),
+            selected=0
+        )
+        tab_panel = TabPanel(general_settings_content)
+        return Tabs(tab_list, tab_panel)
+    """
+    return Div(
+        tab_list,
+        tab_panel,
+        class_=stringify(styles.tabs.container, cls),
+    )