refactor: restructure project into muxplex/ subdir with brand integration

- Move coordinator/, frontend/, Caddyfile, pyproject.toml, requirements.txt, docs/ into muxplex/ subdir in prep for packaging/sharing - Add brand assets to frontend/: favicon.ico, pwa-192/512.png, apple-touch-icon.png, wordmark-on-dark.svg - Update app: title → muxplex, header → wordmark SVG, brand color tokens in style.css, manifest.json updated with muxplex name and brand icons - Add design system: assets/branding/tokens.css (101 CSS custom properties), tokens.json (127 tokens), DESIGN-SYSTEM.md (856-line spec) - Add assets/branding/: SVG sources, rendered PNGs (icons, favicons, PWA, OG) - Add scripts/render-brand-assets.py for reproducible PNG generation - Add muxplex/README.md
2026-03-27 15:06:00 -07:00
commit 8234e2ec05
76 changed files with 17006 additions and 0 deletions
@@ -0,0 +1,165 @@
+"""Tests for frontend/index.html — verifies presence of all required DOM elements."""
+
+import pathlib
+
+from bs4 import BeautifulSoup
+
+HTML_PATH = pathlib.Path(__file__).parent.parent.parent / "frontend" / "index.html"
+
+# Parse once per module — tests are read-only so sharing is safe.
+_SOUP: BeautifulSoup = BeautifulSoup(HTML_PATH.read_text(), "html.parser")
+
+
+def test_html_pwa_meta() -> None:
+    """apple-mobile-web-app-capable, rel=manifest, theme-color, apple-mobile-web-app-status-bar-style."""
+    soup = _SOUP
+    # rel=manifest
+    assert soup.find("link", rel="manifest"), "Missing <link rel='manifest'>"
+    # theme-color
+    assert soup.find("meta", attrs={"name": "theme-color"}), (
+        "Missing <meta name='theme-color'>"
+    )
+    # apple-mobile-web-app-capable
+    assert soup.find("meta", attrs={"name": "apple-mobile-web-app-capable"}), (
+        "Missing <meta name='apple-mobile-web-app-capable'>"
+    )
+    # apple-mobile-web-app-status-bar-style
+    assert soup.find("meta", attrs={"name": "apple-mobile-web-app-status-bar-style"}), (
+        "Missing <meta name='apple-mobile-web-app-status-bar-style'>"
+    )
+
+
+def test_html_viewport_suppresses_pinch_zoom() -> None:
+    """viewport must include maximum-scale=1.0 and user-scalable=no."""
+    soup = _SOUP
+    viewport = soup.find("meta", attrs={"name": "viewport"})
+    assert viewport, "Missing <meta name='viewport'>"
+    content = str(viewport.get("content", ""))  # type: ignore[union-attr]
+    assert "maximum-scale=1.0" in content, (
+        f"viewport missing maximum-scale=1.0: {content!r}"
+    )
+    assert "user-scalable=no" in content, (
+        f"viewport missing user-scalable=no: {content!r}"
+    )
+
+
+def test_html_required_views() -> None:
+    """id=view-overview, view-expanded, session-grid, terminal-container, empty-state."""
+    soup = _SOUP
+    for id_ in (
+        "view-overview",
+        "view-expanded",
+        "session-grid",
+        "terminal-container",
+        "empty-state",
+    ):
+        assert soup.find(id=id_), f"Missing element with id='{id_}'"
+
+
+def test_html_expanded_view_elements() -> None:
+    """id=back-btn, expanded-session-name, palette-trigger, reconnect-overlay."""
+    soup = _SOUP
+    for id_ in (
+        "back-btn",
+        "expanded-session-name",
+        "palette-trigger",
+        "reconnect-overlay",
+    ):
+        assert soup.find(id=id_), f"Missing element with id='{id_}'"
+
+
+def test_html_command_palette() -> None:
+    """id=command-palette, palette-input, palette-list, palette-backdrop."""
+    soup = _SOUP
+    for id_ in ("command-palette", "palette-input", "palette-list", "palette-backdrop"):
+        assert soup.find(id=id_), f"Missing element with id='{id_}'"
+
+
+def test_html_bottom_sheet() -> None:
+    """id=bottom-sheet, sheet-list, sheet-backdrop, session-pill, session-pill-label, session-pill-bell."""
+    soup = _SOUP
+    for id_ in (
+        "bottom-sheet",
+        "sheet-list",
+        "sheet-backdrop",
+        "session-pill",
+        "session-pill-label",
+        "session-pill-bell",
+    ):
+        assert soup.find(id=id_), f"Missing element with id='{id_}'"
+
+
+def test_html_toast() -> None:
+    """id=toast, aria-live=polite."""
+    soup = _SOUP
+    toast = soup.find(id="toast")
+    assert toast, "Missing element with id='toast'"
+    assert toast.get("aria-live") == "polite", (  # type: ignore[union-attr]
+        f"toast missing aria-live=polite, got: {toast.get('aria-live')!r}"  # type: ignore[union-attr]
+    )
+
+
+def test_html_scripts() -> None:
+    """src=/app.js, src=/terminal.js, xterm."""
+    soup = _SOUP
+    scripts = soup.find_all("script")
+    srcs = [str(s.get("src", "")) for s in scripts]
+    assert any("/app.js" in s for s in srcs), (
+        f"Missing script src=/app.js; found: {srcs}"
+    )
+    assert any("/terminal.js" in s for s in srcs), (
+        f"Missing script src=/terminal.js; found: {srcs}"
+    )
+    assert any("xterm" in s for s in srcs), f"Missing xterm script; found: {srcs}"
+
+
+def test_html_xterm_css() -> None:
+    """xterm.css CDN link present."""
+    soup = _SOUP
+    links = soup.find_all("link", rel="stylesheet")
+    hrefs = [str(lnk.get("href", "")) for lnk in links]
+    assert any("xterm.css" in h for h in hrefs), (
+        f"Missing xterm.css link; found: {hrefs}"
+    )
+
+
+def test_html_style_css() -> None:
+    """href=/style.css present."""
+    soup = _SOUP
+    links = soup.find_all("link", rel="stylesheet")
+    hrefs = [str(lnk.get("href", "")) for lnk in links]
+    assert any("/style.css" in h for h in hrefs), (
+        f"Missing /style.css link; found: {hrefs}"
+    )
+
+
+def test_html_element_classes() -> None:
+    """Critical and important elements must carry their CSS styling classes."""
+    soup = _SOUP
+    cases = [
+        # (element_id, required_class, reason)
+        ("terminal-container", "terminal-container", "xterm.js needs flex:1 to render"),
+        (
+            "reconnect-overlay",
+            "reconnect-overlay",
+            "needs position:absolute to overlay terminal",
+        ),
+        ("session-pill", "session-pill", "needs position:fixed to float"),
+        ("toast", "toast", "needs position:fixed and animation"),
+        ("back-btn", "back-btn", "needs border and hover styles"),
+        ("palette-trigger", "palette-trigger", "needs border and hover styles"),
+        (
+            "expanded-session-name",
+            "expanded-session-name",
+            "needs text-overflow:ellipsis",
+        ),
+        ("session-pill-label", "session-pill__label", "needs max-width truncation"),
+        ("session-pill-bell", "session-pill__bell", "needs amber var(--bell) color"),
+    ]
+    for el_id, expected_class, reason in cases:
+        el = soup.find(id=el_id)
+        assert el is not None, f"#{el_id} not found in HTML"
+        classes = el.get("class") or []
+        assert expected_class in classes, (
+            f"#{el_id} is missing class '{expected_class}' — {reason}. Has: {classes}"
+        )