eidosui 0.1.0__tar.gz → 0.2.0__tar.gz

eidosui-0.2.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.2.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: eidosui
+Version: 0.2.0
+Summary: A modern, Tailwind CSS-based UI library for Python web frameworks
+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: 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: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: air
+Requires-Dist: fastapi
+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'
+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.2.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.2.0/eidos/__init__.py

@@ -0,0 +1,2 @@
+from . import tags
+from . import styles

eidosui-0.2.0/eidos/components/headers.py

@@ -0,0 +1,29 @@
+from air import Meta, Script, Link, Html, Head, Title
+from ..tags import Body
+
+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=True, theme="light"):
+    """Standard EidosUI headers with CSS includes."""
+    headers = [
+        Meta(charset="UTF-8"),
+        Meta(name="viewport", content="width=device-width, initial-scale=1.0"),
+    ]
+    
+    if include_tailwind:
+        headers.append(Script(src="https://cdn.tailwindcss.com"))
+    
+    # Add EidosUI CSS files
+    for css_url in get_css_urls():
+        headers.append(Link(rel="stylesheet", href=css_url))
+    
+    # Set initial theme
+    headers.append(Script(f"document.documentElement.setAttribute('data-theme', '{theme}');"))
+    
+    return headers

eidosui-0.2.0/eidos/css/styles.css

@@ -0,0 +1,337 @@
+/* EidosUI Button Styles - Simplified for CDN */
+
+/* Base Button - One size that works everywhere */
+.eidos-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: var(--space-sm) var(--space-md);
+    font-size: var(--font-size-base);
+    font-weight: var(--font-weight-medium);
+    line-height: var(--line-height-normal);
+    border-radius: var(--radius-md);
+    border: none;
+    cursor: pointer;
+    text-decoration: none;
+    transition: all var(--transition-fast);
+    outline: none;
+    user-select: none;
+}
+
+.eidos-btn:focus-visible {
+    outline: var(--border-2) solid currentColor;
+    outline-offset: var(--border-2);
+}
+
+.eidos-btn:active {
+    transform: scale(0.98);
+}
+
+/* Primary Button */
+.eidos-btn-primary {
+    background-color: var(--color-primary);
+    color: var(--color-primary-foreground);
+}
+
+.eidos-btn-primary:hover {
+    background-color: var(--color-primary-hover);
+}
+
+/* Secondary Button */
+.eidos-btn-secondary {
+    background-color: var(--color-secondary-light);
+    color: var(--color-secondary-dark);
+}
+
+.eidos-btn-secondary:hover {
+    background-color: var(--color-border);
+}
+
+/* Ghost Button */
+.eidos-btn-ghost {
+    background-color: transparent;
+    color: var(--color-secondary-dark);
+}
+
+.eidos-btn-ghost:hover {
+    background-color: rgba(0, 0, 0, var(--opacity-5));
+}
+
+/* Outline Button */
+.eidos-btn-outline {
+    background-color: transparent;
+    border: var(--border-2) solid var(--color-primary);
+    color: var(--color-primary);
+}
+
+.eidos-btn-outline:hover {
+    background-color: var(--color-primary);
+    color: var(--color-primary-foreground);
+}
+
+/* Success Button */
+.eidos-btn-success {
+    background-color: var(--color-success);
+    color: var(--color-success-foreground);
+}
+
+.eidos-btn-success:hover {
+    background-color: var(--color-success-hover);
+}
+
+/* Error Button */
+.eidos-btn-error {
+    background-color: var(--color-error);
+    color: var(--color-error-foreground);
+}
+
+.eidos-btn-error:hover {
+    background-color: var(--color-error-hover);
+}
+
+/* CTA Button */
+.eidos-btn-cta {
+    background-color: var(--color-cta);
+    color: var(--color-cta-foreground);
+}
+
+.eidos-btn-cta:hover {
+    background-color: var(--color-cta-hover);
+}
+
+.eidos-h1 {
+    font-size: var(--font-size-3xl);
+    font-weight: var(--font-weight-bold);
+    line-height: var(--line-height-tight);
+    margin-bottom: var(--space-md);
+}
+
+.eidos-h2 {
+    font-size: var(--font-size-2xl);
+    font-weight: var(--font-weight-semibold);
+    line-height: var(--line-height-snug);
+    margin-bottom: calc(var(--space-sm) * 1.6);
+}
+
+.eidos-h3 {
+    font-size: var(--font-size-xl);
+    font-weight: var(--font-weight-semibold);
+    line-height: var(--line-height-snug);
+    margin-bottom: calc(var(--space-sm) * 1.2);
+}
+
+.eidos-h4 {
+    font-size: var(--font-size-base);
+    font-weight: var(--font-weight-semibold);
+    line-height: var(--line-height-normal);
+    margin-bottom: calc(var(--space-sm) * 0.8);
+}
+
+.eidos-h5 {
+    font-size: var(--font-size-sm);
+    font-weight: var(--font-weight-semibold);
+    line-height: var(--line-height-relaxed);
+    margin-bottom: calc(var(--space-xs) * 0.8);
+}
+
+.eidos-h6 {
+    font-size: var(--font-size-xs);
+    font-weight: var(--font-weight-semibold);
+    line-height: var(--line-height-relaxed);
+    margin-bottom: calc(var(--space-xs) * 0.4);
+}
+
+
+.eidos-body {
+    background-color: var(--color-background);
+    color: var(--color-text);
+    transition: background-color var(--transition-slow), color var(--transition-slow);
+}
+
+/* Semantic HTML Elements */
+
+/* Strong emphasis */
+.eidos-strong {
+    font-weight: var(--font-weight-bold);
+    color: var(--color-text);
+}
+
+/* Italic emphasis */
+.eidos-i {
+    font-style: italic;
+}
+
+/* Small text */
+.eidos-small {
+    font-size: var(--font-size-sm);
+    color: var(--color-text-muted);
+}
+
+/* Deleted text */
+.eidos-del {
+    text-decoration: line-through;
+    color: var(--color-text-muted);
+    opacity: var(--opacity-70);
+}
+
+/* Abbreviation */
+.eidos-abbr {
+    text-decoration: underline dotted;
+    cursor: help;
+    text-decoration-thickness: var(--border);
+    text-underline-offset: 0.2em;
+}
+
+/* Variable */
+.eidos-var {
+    font-family: monospace;
+    font-style: italic;
+    background-color: var(--color-surface);
+    padding: 0 var(--space-xs);
+    border-radius: var(--radius-sm);
+}
+
+/* Summary (for details element) */
+.eidos-summary {
+    cursor: pointer;
+    font-weight: var(--font-weight-medium);
+    padding: var(--space-sm) var(--space-md);
+    background-color: var(--color-surface);
+    border-radius: var(--radius-md);
+    transition: all var(--transition-fast);
+    user-select: none;
+}
+
+.eidos-summary:hover {
+    background-color: var(--color-border);
+}
+
+/* Details */
+.eidos-details {
+    border: var(--border) solid var(--color-border);
+    border-radius: var(--radius-md);
+    margin-bottom: var(--space-md);
+}
+
+.eidos-details[open] .eidos-summary {
+    border-bottom: var(--border) solid var(--color-border);
+    border-radius: var(--radius-md) var(--radius-md) 0 0;
+}
+
+.eidos-details-content {
+    padding: var(--space-md);
+}
+
+/* Blockquote */
+.eidos-blockquote {
+    margin: var(--space-md) 0;
+    padding: var(--space-md) var(--space-lg);
+    border-left: var(--border-4) solid var(--color-primary);
+    background-color: var(--color-surface);
+    font-style: italic;
+    color: var(--color-text-muted);
+}
+
+/* Citation */
+.eidos-cite {
+    font-style: italic;
+    color: var(--color-text-muted);
+}
+
+/* Code elements */
+.eidos-code {
+    font-family: monospace;
+    font-size: var(--font-size-sm);
+    background-color: var(--color-surface);
+    padding: var(--space-xs) var(--space-sm);
+    border-radius: var(--radius-sm);
+    color: var(--color-accent);
+}
+
+/* Preformatted text */
+.eidos-pre {
+    font-family: monospace;
+    font-size: var(--font-size-sm);
+    background-color: var(--color-surface);
+    padding: var(--space-md);
+    border-radius: var(--radius-md);
+    overflow-x: auto;
+    line-height: var(--line-height-relaxed);
+    border: var(--border) solid var(--color-border);
+}
+
+/* Keyboard input */
+.eidos-kbd {
+    font-family: monospace;
+    font-size: var(--font-size-sm);
+    background-color: var(--color-surface);
+    padding: var(--space-xs) var(--space-sm);
+    border: var(--border) solid var(--color-border);
+    border-radius: var(--radius-sm);
+    box-shadow: var(--shadow-xs);
+    display: inline-block;
+    min-width: 1.5em;
+    text-align: center;
+}
+
+/* Sample output */
+.eidos-samp {
+    font-family: monospace;
+    font-size: var(--font-size-sm);
+    color: var(--color-text-muted);
+}
+
+/* Mark/highlight */
+.eidos-mark {
+    background-color: var(--color-warning);
+    color: var(--color-text);
+    padding: 0 var(--space-xs);
+    border-radius: var(--radius-sm);
+}
+
+/* Time */
+.eidos-time {
+    color: var(--color-text-muted);
+}
+
+/* Address */
+.eidos-address {
+    font-style: normal;
+    line-height: var(--line-height-relaxed);
+    color: var(--color-text-muted);
+}
+
+/* Definition list */
+.eidos-dl {
+    margin: var(--space-md) 0;
+}
+
+.eidos-dt {
+    font-weight: var(--font-weight-semibold);
+    margin-bottom: var(--space-xs);
+}
+
+.eidos-dd {
+    margin-left: var(--space-lg);
+    margin-bottom: var(--space-sm);
+    color: var(--color-text-muted);
+}
+
+/* Figure */
+.eidos-figure {
+    margin: var(--space-lg) 0;
+    text-align: center;
+}
+
+.eidos-figcaption {
+    font-size: var(--font-size-sm);
+    color: var(--color-text-muted);
+    margin-top: var(--space-sm);
+}
+
+/* Horizontal rule */
+.eidos-hr {
+    border: none;
+    border-top: var(--border) solid var(--color-border);
+    margin: var(--space-xl) 0;
+}