voodoo-framework 2.8.0__tar.gz → 2.8.2__tar.gz

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voodoo-framework
-Version: 2.8.0
+Version: 2.8.2
 Summary: The programmable runtime for adaptive applications and operational systems — web, APIs, agents, workers, human workflows, distributed systems, and physical systems in one runtime.
 Author-email: Helder Perez <contact@helderperez.com>
 Maintainer-email: Helder Perez <contact@helderperez.com>

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo/__init__.py

@@ -105,7 +105,7 @@ from .ui.styles import (
 from .ui.styles.theme import Theme, ThemeColors, create_theme
 from .workers import task
 
-__version__ = "2.8.0"
+__version__ = "2.8.2"
 
 __all__ = [
     # Core runtime

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo/core/app.py

@@ -355,6 +355,14 @@ def create_app(app_dir: str = "app") -> Starlette:  # noqa: C901
         Middleware(AuthMiddleware),
     ]
 
+    # ``public/`` is the filesystem root for static assets, not part of their
+    # public URL. Keep the explicit ``/public`` mount above for 2.x compatibility,
+    # then add a root mount last so application/runtime routes always win.
+    if os.path.isdir(public_dir):
+        routes.append(
+            Mount("/", app=StaticFiles(directory=public_dir), name="public-root")
+        )
+
     app = Starlette(
         debug=config.debug,
         routes=routes,

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo/ui/__init__.py

@@ -12,6 +12,7 @@ Voodoo::
     Button("Save", on_click=save)
 """
 
+from voodoo.ui.brand import Brand
 from voodoo.ui.component import Component, Html, escape, tone_to_color_var
 from voodoo.ui.events import UIEvent
 from voodoo.ui.interactive import (
@@ -36,7 +37,6 @@ from voodoo.ui.library import (
     BackLink,
     Badge,
     Box,
-    Brand,
     Card,
     ChatBox,
     ChatMessage,

voodoo_framework-2.8.2/src/voodoo/ui/brand.py

@@ -0,0 +1,137 @@
+"""Branding primitives for logos and wordmarks.
+
+``Brand`` preserves the existing child-based API while adding a first-class
+image mode that can switch logo assets with the active light/dark theme.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from voodoo.ui.component import Component
+
+BRAND_CSS = """
+/* Brand image contract */
+.vd-brand-logo {
+    display: block;
+    max-width: 100%;
+    height: auto;
+    border-radius: 0 !important;
+}
+.vd-brand-logo--light { display: block; }
+.vd-brand-logo--dark { display: none; }
+.dark .vd-brand-logo--light { display: none; }
+.dark .vd-brand-logo--dark { display: block; }
+"""
+
+
+class _BrandLogo(Component):
+    """Internal logo image with no generic ``Img`` presentation styles."""
+
+    tag = "img"
+    auto_id = False
+
+    def __init__(
+        self,
+        *,
+        src: str,
+        alt: str,
+        variant: str | None = None,
+        width: str | int | None = None,
+        height: str | int | None = None,
+    ) -> None:
+        classes = "vd-brand-logo"
+        if variant:
+            classes += f" vd-brand-logo--{variant}"
+        super().__init__(class_=classes)
+        self.attrs["src"] = src
+        self.attrs["alt"] = alt
+        if width is not None:
+            self.attrs["width"] = width
+        if height is not None:
+            self.attrs["height"] = height
+
+
+class Brand(Component):
+    """Brand link supporting either child content or theme-aware logo assets.
+
+    Existing usage remains valid::
+
+        Brand("Acme", href="/")
+        Brand(Img(src="/logo.png", alt="Acme"), href="/")
+
+    Image mode keeps branding free of generic image presentation styles and
+    automatically selects the correct asset for the active theme::
+
+        Brand(
+            light="/logo-black.png",
+            dark="/logo-white.png",
+            alt="Acme",
+            width=160,
+            href="/",
+        )
+
+    When only ``light`` or ``dark`` is supplied, that asset is used for both
+    themes. Image mode and explicit children are intentionally mutually
+    exclusive so the rendered brand stays unambiguous.
+    """
+
+    tag = "a"
+    style = "brand"
+
+    def __init__(
+        self,
+        *children: Any,
+        href: str = "/",
+        light: str | None = None,
+        dark: str | None = None,
+        alt: str = "",
+        width: str | int | None = None,
+        height: str | int | None = None,
+        **kwargs: Any,
+    ) -> None:
+        image_mode = light is not None or dark is not None
+        if image_mode and children:
+            raise ValueError(
+                "Brand image mode cannot be combined with child content. "
+                "Use either Brand(...children) or Brand(light=..., dark=...)."
+            )
+
+        super().__init__(*children, **kwargs)
+        self.attrs["href"] = href
+
+        if not image_mode:
+            return
+
+        light_src = light or dark
+        dark_src = dark or light
+        assert light_src is not None
+        assert dark_src is not None
+
+        if light_src == dark_src:
+            self.children = (
+                _BrandLogo(
+                    src=light_src,
+                    alt=alt,
+                    width=width,
+                    height=height,
+                ),
+            )
+            return
+
+        self.children = (
+            _BrandLogo(
+                src=light_src,
+                alt=alt,
+                variant="light",
+                width=width,
+                height=height,
+            ),
+            _BrandLogo(
+                src=dark_src,
+                alt=alt,
+                variant="dark",
+                width=width,
+                height=height,
+            ),
+        )

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo/ui/rendering.py

@@ -40,6 +40,7 @@ def render_page(component: Any, seo: Any = None) -> str:
     """Render a complete HTML document for a Voodoo component tree."""
     from voodoo.config import config
     from voodoo.seo import SEO
+    from voodoo.ui.brand import BRAND_CSS
     from voodoo.ui.component import Component
     from voodoo.ui.styles.theme import default_theme
 
@@ -162,6 +163,9 @@ def render_page(component: Any, seo: Any = None) -> str:
             /* Stable primitive component layer */
             {component_css}
 
+            /* Brand asset switching */
+            {BRAND_CSS}
+
             /* Voodoo Design System 3 */
             {design_system_css}
 

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voodoo-framework
-Version: 2.8.0
+Version: 2.8.2
 Summary: The programmable runtime for adaptive applications and operational systems — web, APIs, agents, workers, human workflows, distributed systems, and physical systems in one runtime.
 Author-email: Helder Perez <contact@helderperez.com>
 Maintainer-email: Helder Perez <contact@helderperez.com>

{voodoo_framework-2.8.0 → voodoo_framework-2.8.2}/src/voodoo_framework.egg-info/SOURCES.txt

@@ -200,6 +200,7 @@ src/voodoo/telemetry/store.py
 src/voodoo/tools/__init__.py
 src/voodoo/tools/registry.py
 src/voodoo/ui/__init__.py
+src/voodoo/ui/brand.py
 src/voodoo/ui/component.py
 src/voodoo/ui/events.py
 src/voodoo/ui/interactive.py
@@ -238,6 +239,7 @@ tests/test_agent_registry.py
 tests/test_agent_runtime.py
 tests/test_app.py
 tests/test_auth.py
+tests/test_brand.py
 tests/test_capability_security.py
 tests/test_checkpoint_resume.py
 tests/test_chrome.py
@@ -302,6 +304,7 @@ tests/test_protocol_operational.py
 tests/test_provider_switching.py
 tests/test_providers.py
 tests/test_public_api_3.py
+tests/test_public_assets.py
 tests/test_queue.py
 tests/test_reactive.py
 tests/test_runtime.py

voodoo_framework-2.8.2/tests/test_brand.py

@@ -0,0 +1,61 @@
+"""Tests for the theme-aware Brand component."""
+
+import pytest
+
+from voodoo.ui import Brand
+from voodoo.ui.brand import BRAND_CSS
+from voodoo.ui.rendering import render_page
+
+
+def test_brand_preserves_child_based_api():
+    html = Brand("Voodoo", href="/home").render()
+
+    assert 'href="/home"' in html
+    assert ">Voodoo</a>" in html
+    assert "vd-brand-logo" not in html
+
+
+def test_brand_renders_theme_specific_assets_without_generic_img_style():
+    html = Brand(
+        light="/logo-black.png",
+        dark="/logo-white.png",
+        alt="Voodoo",
+        width=160,
+        href="/",
+    ).render()
+
+    assert 'src="/logo-black.png"' in html
+    assert 'src="/logo-white.png"' in html
+    assert 'alt="Voodoo"' in html
+    assert 'width="160"' in html
+    assert "vd-brand-logo--light" in html
+    assert "vd-brand-logo--dark" in html
+    assert "vd-img" not in html
+
+
+def test_brand_single_asset_is_shared_by_both_themes():
+    html = Brand(light="/logo.svg", alt="Acme").render()
+
+    assert html.count("<img") == 1
+    assert 'src="/logo.svg"' in html
+    assert "vd-brand-logo--light" not in html
+    assert "vd-brand-logo--dark" not in html
+
+
+def test_brand_rejects_children_in_image_mode():
+    with pytest.raises(ValueError, match="cannot be combined"):
+        Brand("Voodoo", light="/logo.svg")
+
+
+def test_brand_css_switches_assets_and_removes_radius():
+    assert "border-radius: 0 !important" in BRAND_CSS
+    assert ".dark .vd-brand-logo--light { display: none; }" in BRAND_CSS
+    assert ".dark .vd-brand-logo--dark { display: block; }" in BRAND_CSS
+
+
+def test_render_page_includes_brand_css():
+    html = render_page(Brand(light="/logo-black.png", dark="/logo-white.png"))
+
+    assert "/* Brand asset switching */" in html
+    assert ".vd-brand-logo--light" in html
+    assert ".dark .vd-brand-logo--dark" in html

voodoo_framework-2.8.2/tests/test_public_assets.py

@@ -0,0 +1,48 @@
+"""Acceptance tests for the public asset URL contract."""
+
+from starlette.testclient import TestClient
+
+from voodoo import App
+
+
+def test_public_assets_are_served_from_root_without_shadowing_pages(
+    tmp_path, monkeypatch
+):
+    monkeypatch.chdir(tmp_path)
+
+    app_dir = tmp_path / "app"
+    app_dir.mkdir()
+    (app_dir / "page.py").write_text(
+        "from voodoo.ui import Text\n\n"
+        "def page(request):\n"
+        "    return Text('Application page wins')\n"
+    )
+
+    public_dir = tmp_path / "public"
+    (public_dir / "assets").mkdir(parents=True)
+    (public_dir / "logo.txt").write_text("voodoo-logo")
+    (public_dir / "assets" / "icon.txt").write_text("voodoo-icon")
+    # A static index must never shadow the application root route.
+    (public_dir / "index.html").write_text("STATIC INDEX")
+
+    with TestClient(App(app_dir=str(app_dir))) as client:
+        root = client.get("/")
+        logo = client.get("/logo.txt")
+        nested = client.get("/assets/icon.txt")
+        legacy = client.get("/public/logo.txt")
+        missing = client.get("/does-not-exist.txt")
+
+    assert root.status_code == 200
+    assert "Application page wins" in root.text
+    assert "STATIC INDEX" not in root.text
+
+    assert logo.status_code == 200
+    assert logo.text == "voodoo-logo"
+    assert nested.status_code == 200
+    assert nested.text == "voodoo-icon"
+
+    # Preserve the 2.x URL as a compatibility alias while root URLs become canonical.
+    assert legacy.status_code == 200
+    assert legacy.text == "voodoo-logo"
+
+    assert missing.status_code == 404