create-hedgeboard 1.0.7 → 1.1.0

package/hedgeboard/viz/dashboard.py

@@ -1,330 +0,0 @@
-"""Dashboard renderer.
-
-Generates full HTML pages with branded styling, Chart.js charts,
-and financial tables. Saves to output/ and serves on localhost.
-
-Usage:
-    from viz.dashboard import render_dashboard
-
-    render_dashboard(
-        title="Twilio Company Overview",
-        sections=[chart_html, table_html, "## Analysis\nKey insight here."],
-        output_name="twilio_overview"
-    )
-"""
-
-from __future__ import annotations
-
-import http.server
-import json
-import os
-import re
-import threading
-import webbrowser
-from datetime import datetime
-from pathlib import Path
-
-_ROOT = Path(__file__).resolve().parent.parent
-_THEME_PATH = _ROOT / "brand" / "theme.json"
-_CSS_PATH = _ROOT / "brand" / "base.css"
-_OUTPUT_DIR = _ROOT / "output"
-
-
-def _load_theme() -> dict:
-    try:
-        with open(_THEME_PATH) as f:
-            return json.load(f)
-    except (FileNotFoundError, json.JSONDecodeError):
-        return {
-            "name": "HedgeBoard",
-            "colors": {
-                "primary": "#EAEAEA",
-                "accent": "#CACACA",
-                "positive": "#4ADE80",
-                "negative": "#F87171",
-                "background": "#0C0C10",
-                "surface": "#151519",
-                "text": "#EAEAEA",
-                "text_secondary": "#B0B0B8",
-                "muted": "#6B6B78",
-                "border": "#2A2A33",
-            },
-            "font": {"family": "Space Grotesk", "headings": "Space Grotesk", "mono": "IBM Plex Mono"},
-            "mode": "dark",
-        }
-
-
-def _load_css() -> str:
-    try:
-        return _CSS_PATH.read_text()
-    except FileNotFoundError:
-        return ""
-
-
-def _markdown_to_html(text: str) -> str:
-    """Minimal markdown conversion for analysis sections."""
-    # Headers
-    text = re.sub(r"^### (.+)$", r"<h3>\1</h3>", text, flags=re.MULTILINE)
-    text = re.sub(r"^## (.+)$", r"<h2>\1</h2>", text, flags=re.MULTILINE)
-    text = re.sub(r"^# (.+)$", r"<h1>\1</h1>", text, flags=re.MULTILINE)
-    # Bold and italic
-    text = re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", text)
-    text = re.sub(r"\*(.+?)\*", r"<em>\1</em>", text)
-    # Line breaks → paragraphs
-    paragraphs = text.split("\n\n")
-    result = []
-    for p in paragraphs:
-        p = p.strip()
-        if not p:
-            continue
-        if p.startswith("<h") or p.startswith("<div") or p.startswith("<table"):
-            result.append(p)
-        else:
-            result.append(f"<p>{p}</p>")
-    return "\n".join(result)
-
-
-def render_dashboard(
-    title: str,
-    sections: list[str],
-    output_name: str | None = None,
-    serve: bool = True,
-    port: int = 4747,
-) -> Path:
-    """Render a full branded dashboard page.
-
-    Args:
-        title: Dashboard title.
-        sections: List of HTML snippets or markdown text. Each becomes
-                  a section in the dashboard.
-        output_name: Folder name under output/. Auto-generated if None.
-        serve: If True, start a local HTTP server and open in browser.
-        port: Port for the local server.
-
-    Returns:
-        Path to the generated index.html.
-    """
-    theme = _load_theme()
-    colors = theme.get("colors", {})
-    font = theme.get("font", {})
-    brand_name = theme.get("name", "HedgeBoard")
-    css = _load_css()
-
-    # Generate output folder name
-    if not output_name:
-        slug = re.sub(r"[^a-z0-9]+", "_", title.lower()).strip("_")
-        output_name = f"{slug}_{datetime.now().strftime('%Y%m%d_%H%M')}"
-
-    output_dir = _OUTPUT_DIR / output_name
-    output_dir.mkdir(parents=True, exist_ok=True)
-
-    # Logo
-    logo_path = theme.get("logo", "")
-    logo_html = ""
-    if logo_path:
-        abs_logo = _ROOT / logo_path
-        if abs_logo.exists():
-            logo_html = f'<img src="../../{logo_path}" alt="{brand_name}" style="height:32px;margin-right:12px;">'
-
-    # Build sections HTML
-    sections_html = []
-    for section in sections:
-        if section.strip().startswith("<"):
-            # Already HTML (chart or table)
-            sections_html.append(
-                f'<div class="section">{section}</div>'
-            )
-        else:
-            # Markdown text
-            sections_html.append(
-                f'<div class="section text-section">{_markdown_to_html(section)}</div>'
-            )
-
-    font_family = font.get("family", "Space Grotesk")
-    heading_font = font.get("headings", font_family)
-    mono_font = font.get("mono", "IBM Plex Mono")
-
-    html = f"""<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{title} — {brand_name}</title>
-    <link href="https://fonts.googleapis.com/css2?family={font_family.replace(' ', '+')}:wght@400;500;600;700&family={heading_font.replace(' ', '+')}:wght@600;700&family={mono_font.replace(' ', '+')}:wght@400;500;600&display=swap" rel="stylesheet">
-    <script src="https://cdn.jsdelivr.net/npm/chart.js@4"></script>
-    <style>
-        :root {{
-            --color-primary: {colors.get('primary', '#EAEAEA')};
-            --color-accent: {colors.get('accent', '#CACACA')};
-            --color-positive: {colors.get('positive', '#4ADE80')};
-            --color-negative: {colors.get('negative', '#F87171')};
-            --color-bg: {colors.get('background', '#0C0C10')};
-            --color-surface: {colors.get('surface', '#151519')};
-            --color-text: {colors.get('text', '#EAEAEA')};
-            --color-muted: {colors.get('muted', '#6B6B78')};
-            --color-border: {colors.get('border', '#2A2A33')};
-            --font-body: '{font_family}', system-ui, sans-serif;
-            --font-heading: '{heading_font}', system-ui, sans-serif;
-            --font-mono: '{mono_font}', monospace;
-        }}
-
-        * {{ margin: 0; padding: 0; box-sizing: border-box; }}
-
-        body {{
-            background: var(--color-bg);
-            color: var(--color-text);
-            font-family: var(--font-body);
-            line-height: 1.6;
-            min-height: 100vh;
-        }}
-
-        .header {{
-            display: flex;
-            align-items: center;
-            padding: 20px 40px;
-            border-bottom: 1px solid var(--color-surface);
-        }}
-
-        .header h1 {{
-            font-family: var(--font-heading);
-            font-size: 20px;
-            font-weight: 700;
-            color: var(--color-text);
-        }}
-
-        .header .brand {{
-            margin-left: auto;
-            font-family: var(--font-mono);
-            font-size: 11px;
-            color: var(--color-muted);
-            text-transform: uppercase;
-            letter-spacing: 1.5px;
-        }}
-
-        .container {{
-            max-width: 1200px;
-            margin: 0 auto;
-            padding: 32px 40px;
-        }}
-
-        .section {{
-            margin-bottom: 24px;
-        }}
-
-        .text-section h2 {{
-            font-family: var(--font-heading);
-            font-size: 20px;
-            font-weight: 700;
-            color: var(--color-text);
-            margin-bottom: 12px;
-            margin-top: 24px;
-        }}
-
-        .text-section h3 {{
-            font-family: var(--font-heading);
-            font-size: 16px;
-            font-weight: 600;
-            color: var(--color-text);
-            margin-bottom: 8px;
-            margin-top: 16px;
-        }}
-
-        .text-section p {{
-            color: var(--color-muted);
-            font-size: 14px;
-            margin-bottom: 12px;
-            line-height: 1.7;
-        }}
-
-        .text-section strong {{
-            color: var(--color-text);
-        }}
-
-        .footer {{
-            padding: 20px 40px;
-            border-top: 1px solid var(--color-surface);
-            text-align: center;
-            font-family: var(--font-mono);
-            font-size: 11px;
-            color: var(--color-muted);
-        }}
-
-        {css}
-    </style>
-</head>
-<body>
-    <div class="header">
-        {logo_html}
-        <h1>{title}</h1>
-        <div class="brand">{brand_name}</div>
-    </div>
-    <div class="container">
-        {''.join(sections_html)}
-    </div>
-    <div class="footer">
-        Generated {datetime.now().strftime('%b %d, %Y at %H:%M')} &middot; {brand_name}
-    </div>
-</body>
-</html>"""
-
-    # Write output
-    index_path = output_dir / "index.html"
-    index_path.write_text(html)
-
-    print(f"📊 Dashboard saved to {index_path}")
-
-    if serve:
-        _serve_and_open(output_dir, index_path, port)
-
-    return index_path
-
-
-def _serve_and_open(directory: Path, index_path: Path, port: int) -> None:
-    """Start a local HTTP server and open the dashboard in a browser.
-
-    The server runs on the main thread so it stays alive until the user
-    presses Ctrl+C.  The browser is opened from a background thread after
-    a short delay so it doesn't race the server startup.
-    """
-
-    class QuietHandler(http.server.SimpleHTTPRequestHandler):
-        def __init__(self, *args, **kwargs):
-            super().__init__(*args, directory=str(directory), **kwargs)
-
-        def log_message(self, format, *args):
-            pass  # Suppress logs
-
-    # Find an available port
-    server = None
-    for p in (port, port + 1):
-        try:
-            server = http.server.HTTPServer(("", p), QuietHandler)
-            port = p
-            break
-        except OSError:
-            continue
-
-    if server is None:
-        print("⚠️  Could not start HTTP server, opening file directly")
-        webbrowser.open(f"file://{index_path.resolve()}")
-        return
-
-    server_url = f"http://localhost:{port}"
-    print(f"🌐 Serving at {server_url}")
-    print("   Press Ctrl+C to stop the server.")
-
-    # Open browser from a background thread (small delay so server is ready)
-    def _open():
-        import time
-        time.sleep(0.4)
-        webbrowser.open(server_url)
-
-    threading.Thread(target=_open, daemon=True).start()
-
-    # Block the main thread — keeps the server alive
-    try:
-        server.serve_forever()
-    except KeyboardInterrupt:
-        print("\n🛑 Server stopped.")
-        server.shutdown()
-

package/hedgeboard/viz/tables.py

@@ -1,140 +0,0 @@
-"""Financial table generation.
-
-Generates styled HTML tables with number formatting, branded colors,
-and support for positive/negative value highlighting.
-
-Usage:
-    from viz.tables import financial_table
-
-    html = financial_table(
-        headers=["Metric", "2023", "2024"],
-        rows=[
-            ["Revenue", 3826000000, 4150000000],
-            ["Net Income", -398000000, 120000000],
-        ]
-    )
-"""
-
-from __future__ import annotations
-
-import json
-from pathlib import Path
-
-_THEME_PATH = Path(__file__).resolve().parent.parent / "brand" / "theme.json"
-
-
-def _load_theme() -> dict:
-    try:
-        with open(_THEME_PATH) as f:
-            return json.load(f)
-    except (FileNotFoundError, json.JSONDecodeError):
-        return {
-            "colors": {
-                "primary": "#6366F1",
-                "accent": "#22D3EE",
-                "background": "#0D1117",
-                "surface": "#161B22",
-                "text": "#E6EDF3",
-                "muted": "#8B949E",
-            }
-        }
-
-
-def _format_number(val) -> str:
-    """Format a number for financial display."""
-    if val is None:
-        return "—"
-    if isinstance(val, str):
-        return val
-
-    num = float(val)
-    abs_num = abs(num)
-
-    if abs_num >= 1_000_000_000:
-        formatted = f"${abs_num / 1_000_000_000:.1f}B"
-    elif abs_num >= 1_000_000:
-        formatted = f"${abs_num / 1_000_000:.1f}M"
-    elif abs_num >= 1_000:
-        formatted = f"${abs_num / 1_000:.1f}K"
-    else:
-        formatted = f"${abs_num:,.2f}"
-
-    if num < 0:
-        return f"({formatted})"
-    return formatted
-
-
-def financial_table(
-    headers: list[str],
-    rows: list[list],
-    title: str = "",
-    format_numbers: bool = True,
-) -> str:
-    """Generate a styled financial table.
-
-    Args:
-        headers: Column headers.
-        rows: List of rows, each a list of values. First column is
-              typically the metric name (string), rest are numbers.
-        title: Optional table title.
-        format_numbers: Auto-format numbers (B/M/K, negative in parens).
-
-    Returns:
-        HTML string with a styled table.
-    """
-    theme = _load_theme()
-    colors = theme.get("colors", {})
-
-    bg = colors.get("surface", "#161B22")
-    border = colors.get("background", "#0D1117")
-    text = colors.get("text", "#E6EDF3")
-    muted = colors.get("muted", "#8B949E")
-    accent = colors.get("accent", "#22D3EE")
-
-    # Build header row
-    header_cells = "".join(
-        f'<th style="padding:12px 16px;text-align:{"left" if i == 0 else "right"};'
-        f'color:{accent};font-weight:600;border-bottom:2px solid {border};'
-        f'font-size:13px;text-transform:uppercase;letter-spacing:0.5px;">'
-        f"{h}</th>"
-        for i, h in enumerate(headers)
-    )
-
-    # Build body rows
-    body_rows = []
-    for row in rows:
-        cells = []
-        for i, val in enumerate(row):
-            if i == 0:
-                # Metric name column
-                cell = (
-                    f'<td style="padding:10px 16px;color:{text};font-weight:500;'
-                    f'border-bottom:1px solid {border};">{val}</td>'
-                )
-            else:
-                # Value column
-                display = _format_number(val) if format_numbers else str(val)
-                is_negative = isinstance(val, (int, float)) and val < 0
-                val_color = "#EF4444" if is_negative else text
-                cell = (
-                    f'<td style="padding:10px 16px;text-align:right;color:{val_color};'
-                    f'font-variant-numeric:tabular-nums;border-bottom:1px solid {border};'
-                    f'font-family:monospace;">{display}</td>'
-                )
-            cells.append(cell)
-        body_rows.append(f"<tr>{''.join(cells)}</tr>")
-
-    title_html = ""
-    if title:
-        title_html = (
-            f'<div style="padding:16px 16px 0;color:{text};font-size:16px;'
-            f'font-weight:600;">{title}</div>'
-        )
-
-    return f"""{title_html}
-<div style="background:{bg};border-radius:12px;overflow:hidden;">
-  <table style="width:100%;border-collapse:collapse;font-size:14px;">
-    <thead><tr>{header_cells}</tr></thead>
-    <tbody>{''.join(body_rows)}</tbody>
-  </table>
-</div>"""