superqode 0.1.5__py3-none-any.whl

superqode/widgets/qe_dashboard.py

@@ -0,0 +1,321 @@
+"""
+QE Dashboard Widget - Quality Metrics Visualization.
+
+A SuperQode-original widget showing real-time quality metrics
+during QE sessions. Displays coverage, complexity, tech debt,
+and active analysis progress.
+
+Design: Distinctive SuperQode visualization that doesn't copy
+from other coding agent tools.
+"""
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from typing import List, Optional
+
+from rich.console import RenderableType
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from rich.progress import Progress, BarColumn, TextColumn, SpinnerColumn
+from textual.reactive import reactive
+from textual.widgets import Static
+from textual.timer import Timer
+
+
+class MetricStatus(Enum):
+    """Status indicator for quality metrics."""
+
+    EXCELLENT = "excellent"  # Green
+    GOOD = "good"  # Blue
+    WARNING = "warning"  # Yellow
+    CRITICAL = "critical"  # Red
+    UNKNOWN = "unknown"  # Gray
+
+
+@dataclass
+class QualityMetric:
+    """A single quality metric."""
+
+    name: str
+    value: float  # 0.0 to 100.0
+    label: str = ""  # e.g., "82%", "Low", "A"
+    status: MetricStatus = MetricStatus.UNKNOWN
+    trend: str = ""  # "↑", "↓", "→"
+
+    @classmethod
+    def coverage(cls, value: float) -> "QualityMetric":
+        """Create a coverage metric."""
+        if value >= 80:
+            status = MetricStatus.EXCELLENT
+        elif value >= 60:
+            status = MetricStatus.GOOD
+        elif value >= 40:
+            status = MetricStatus.WARNING
+        else:
+            status = MetricStatus.CRITICAL
+        return cls("Coverage", value, f"{value:.0f}%", status)
+
+    @classmethod
+    def complexity(cls, value: float) -> "QualityMetric":
+        """Create a complexity metric (lower is better)."""
+        if value <= 10:
+            status, label = MetricStatus.EXCELLENT, "Low"
+        elif value <= 20:
+            status, label = MetricStatus.GOOD, "Medium"
+        elif value <= 30:
+            status, label = MetricStatus.WARNING, "High"
+        else:
+            status, label = MetricStatus.CRITICAL, "Very High"
+        return cls("Complexity", value, label, status)
+
+    @classmethod
+    def tech_debt(cls, value: float) -> "QualityMetric":
+        """Create a tech debt metric (lower is better)."""
+        if value <= 15:
+            status = MetricStatus.EXCELLENT
+        elif value <= 30:
+            status = MetricStatus.GOOD
+        elif value <= 50:
+            status = MetricStatus.WARNING
+        else:
+            status = MetricStatus.CRITICAL
+        return cls("Tech Debt", value, f"{value:.0f}%", status)
+
+    @classmethod
+    def test_health(cls, value: float) -> "QualityMetric":
+        """Create a test health metric."""
+        if value >= 90:
+            status = MetricStatus.EXCELLENT
+        elif value >= 75:
+            status = MetricStatus.GOOD
+        elif value >= 50:
+            status = MetricStatus.WARNING
+        else:
+            status = MetricStatus.CRITICAL
+        return cls("Test Health", value, f"{value:.0f}%", status)
+
+
+@dataclass
+class AnalysisTask:
+    """An active analysis task."""
+
+    file_path: str
+    description: str
+    progress: float = 0.0  # 0.0 to 1.0
+    started_at: datetime = field(default_factory=datetime.now)
+
+
+# Color palette for SuperQode branding
+METRIC_COLORS = {
+    MetricStatus.EXCELLENT: "#22c55e",  # Green
+    MetricStatus.GOOD: "#3b82f6",  # Blue
+    MetricStatus.WARNING: "#eab308",  # Yellow
+    MetricStatus.CRITICAL: "#ef4444",  # Red
+    MetricStatus.UNKNOWN: "#6b7280",  # Gray
+}
+
+
+class QEDashboard(Static):
+    """Quality Engineering Dashboard Widget.
+
+    Displays real-time quality metrics and active analysis progress
+    in a compact, informative panel.
+
+    Usage:
+        dashboard = QEDashboard()
+        dashboard.update_metric(QualityMetric.coverage(82))
+        dashboard.set_active_analysis("src/api/handlers.py", "Checking boundaries...")
+    """
+
+    DEFAULT_CSS = """
+    QEDashboard {
+        height: auto;
+        border: solid #3f3f46;
+        padding: 0 1;
+        margin: 0 0 1 0;
+    }
+    """
+
+    # Reactive state
+    metrics: reactive[List[QualityMetric]] = reactive(list)
+    active_task: reactive[Optional[AnalysisTask]] = reactive(None)
+    is_analyzing: reactive[bool] = reactive(False)
+
+    def __init__(
+        self,
+        title: str = "Quality Pulse",
+        compact: bool = False,
+        **kwargs,
+    ):
+        super().__init__(**kwargs)
+        self.title = title
+        self.compact = compact
+        self._animation_frame = 0
+        self._timer: Optional[Timer] = None
+
+        # Default metrics
+        self._metrics: List[QualityMetric] = [
+            QualityMetric.coverage(0),
+            QualityMetric.complexity(0),
+            QualityMetric.tech_debt(0),
+            QualityMetric.test_health(0),
+        ]
+
+    def on_mount(self) -> None:
+        """Start animation timer when mounted."""
+        self._timer = self.set_interval(0.1, self._tick, pause=True)
+
+    def _tick(self) -> None:
+        """Animation tick."""
+        self._animation_frame += 1
+        if self.active_task:
+            self.refresh()
+
+    def update_metric(self, metric: QualityMetric) -> None:
+        """Update a specific metric by name."""
+        for i, m in enumerate(self._metrics):
+            if m.name == metric.name:
+                self._metrics[i] = metric
+                break
+        else:
+            self._metrics.append(metric)
+        self.refresh()
+
+    def set_metrics(
+        self,
+        coverage: Optional[float] = None,
+        complexity: Optional[float] = None,
+        tech_debt: Optional[float] = None,
+        test_health: Optional[float] = None,
+    ) -> None:
+        """Convenience method to set multiple metrics at once."""
+        if coverage is not None:
+            self.update_metric(QualityMetric.coverage(coverage))
+        if complexity is not None:
+            self.update_metric(QualityMetric.complexity(complexity))
+        if tech_debt is not None:
+            self.update_metric(QualityMetric.tech_debt(tech_debt))
+        if test_health is not None:
+            self.update_metric(QualityMetric.test_health(test_health))
+
+    def set_active_analysis(
+        self,
+        file_path: str,
+        description: str,
+        progress: float = 0.0,
+    ) -> None:
+        """Set the current active analysis task."""
+        self.active_task = AnalysisTask(
+            file_path=file_path,
+            description=description,
+            progress=progress,
+        )
+        self.is_analyzing = True
+        if self._timer:
+            self._timer.resume()
+        self.refresh()
+
+    def update_progress(self, progress: float, description: str = "") -> None:
+        """Update the progress of the active analysis."""
+        if self.active_task:
+            self.active_task.progress = progress
+            if description:
+                self.active_task.description = description
+            self.refresh()
+
+    def clear_analysis(self) -> None:
+        """Clear the active analysis task."""
+        self.active_task = None
+        self.is_analyzing = False
+        if self._timer:
+            self._timer.pause()
+        self.refresh()
+
+    def _render_progress_bar(self, value: float, width: int = 10) -> Text:
+        """Render a progress bar with Unicode blocks."""
+        filled = int(value / 100 * width)
+        empty = width - filled
+
+        bar = Text()
+        bar.append("█" * filled, style="bold #22c55e")
+        bar.append("░" * empty, style="#3f3f46")
+        return bar
+
+    def _render_metric(self, metric: QualityMetric) -> Text:
+        """Render a single metric."""
+        color = METRIC_COLORS[metric.status]
+
+        result = Text()
+        result.append(f"{metric.name}: ", style="#a1a1aa")
+        result.append(self._render_progress_bar(metric.value))
+        result.append(f" {metric.label}", style=f"bold {color}")
+
+        if metric.trend:
+            result.append(f" {metric.trend}", style="#6b7280")
+
+        return result
+
+    def _get_analysis_spinner(self) -> str:
+        """Get animated spinner character."""
+        spinners = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+        return spinners[self._animation_frame % len(spinners)]
+
+    def render(self) -> RenderableType:
+        """Render the dashboard."""
+        content = Text()
+
+        # Metrics row (2x2 grid in compact mode)
+        if self.compact:
+            # Compact: 2 metrics per row
+            for i in range(0, len(self._metrics), 2):
+                row_metrics = self._metrics[i : i + 2]
+                for j, metric in enumerate(row_metrics):
+                    content.append(self._render_metric(metric))
+                    if j < len(row_metrics) - 1:
+                        content.append("   ")
+                content.append("\n")
+        else:
+            # Full: All metrics visible
+            for metric in self._metrics:
+                content.append(self._render_metric(metric))
+                content.append("\n")
+
+        # Active analysis section
+        if self.active_task:
+            content.append("\n")
+
+            # File being analyzed
+            spinner = self._get_analysis_spinner()
+            content.append(f"{spinner} ", style="bold #3b82f6")
+            content.append("Active Analysis: ", style="#a1a1aa")
+
+            # Truncate path if too long
+            path = self.active_task.file_path
+            if len(path) > 35:
+                path = "..." + path[-32:]
+            content.append(path, style="bold #e2e8f0")
+            content.append("\n")
+
+            # Description
+            content.append("  ├─ ", style="#3f3f46")
+            content.append(self.active_task.description, style="#a1a1aa")
+            content.append("\n")
+
+            # Progress bar
+            progress_pct = int(self.active_task.progress * 100)
+            bar_width = 30
+            filled = int(self.active_task.progress * bar_width)
+
+            content.append("  └─ [", style="#3f3f46")
+            content.append("█" * filled, style="bold #3b82f6")
+            content.append("░" * (bar_width - filled), style="#27272a")
+            content.append(f"] {progress_pct}%", style="#3f3f46")
+
+        return Panel(
+            content,
+            title=f"[bold #3b82f6]{self.title}[/]",
+            border_style="#3f3f46",
+            padding=(0, 1),
+        )

superqode/widgets/resizable_sidebar.py

@@ -0,0 +1,377 @@
+"""
+SuperQode Resizable Sidebar - Draggable and Keyboard Resizing.
+
+Provides a resizable sidebar container with:
+- Draggable divider for mouse resize
+- Keyboard shortcuts (Ctrl+[ / Ctrl+]) for resize
+- Min/max width constraints
+- Smooth resize animation
+
+Usage:
+    from superqode.widgets.resizable_sidebar import (
+        ResizableDivider, ResizableSidebarContainer
+    )
+"""
+
+from __future__ import annotations
+
+from typing import Callable, Optional
+
+from textual.widgets import Static
+from textual.containers import Container, Horizontal
+from textual.reactive import reactive
+from textual.events import MouseDown, MouseMove, MouseUp
+from textual.binding import Binding
+from textual.message import Message
+
+from rich.text import Text
+
+
+# ============================================================================
+# DESIGN SYSTEM
+# ============================================================================
+
+try:
+    from superqode.design_system import COLORS as SQ_COLORS, GRADIENT_PURPLE
+except ImportError:
+
+    class SQ_COLORS:
+        primary = "#7c3aed"
+        primary_light = "#a855f7"
+        text_primary = "#fafafa"
+        text_secondary = "#e4e4e7"
+        text_muted = "#a1a1aa"
+        text_dim = "#71717a"
+        text_ghost = "#52525b"
+        border_subtle = "#1a1a1a"
+        border_default = "#27272a"
+
+    GRADIENT_PURPLE = ["#6d28d9", "#7c3aed", "#8b5cf6", "#a855f7"]
+
+
+# ============================================================================
+# RESIZABLE DIVIDER
+# ============================================================================
+
+
+class ResizableDivider(Static):
+    """
+    Draggable divider for resizing adjacent panels.
+
+    SuperQode style: Minimal, purple highlight on hover/drag.
+    """
+
+    DEFAULT_CSS = """
+    ResizableDivider {
+        width: 1;
+        height: 100%;
+        background: #1a1a1a;
+    }
+
+    ResizableDivider:hover {
+        background: #7c3aed;
+    }
+
+    ResizableDivider.dragging {
+        background: #a855f7;
+    }
+    """
+
+    # Messages
+    class Resized(Message):
+        """Posted when divider is dragged."""
+
+        def __init__(self, delta_x: int, screen_x: int) -> None:
+            self.delta_x = delta_x
+            self.screen_x = screen_x
+            super().__init__()
+
+    class ResizeStart(Message):
+        """Posted when resize starts."""
+
+        pass
+
+    class ResizeEnd(Message):
+        """Posted when resize ends."""
+
+        pass
+
+    # State
+    dragging: reactive[bool] = reactive(False)
+
+    def __init__(self, **kwargs):
+        super().__init__("", **kwargs)
+        self._start_x: int = 0
+        self._last_x: int = 0
+
+    def watch_dragging(self, dragging: bool) -> None:
+        """Update visual state when dragging changes."""
+        if dragging:
+            self.add_class("dragging")
+        else:
+            self.remove_class("dragging")
+
+    def on_mouse_down(self, event: MouseDown) -> None:
+        """Start dragging."""
+        self.dragging = True
+        self._start_x = event.screen_x
+        self._last_x = event.screen_x
+        self.capture_mouse()
+        self.post_message(self.ResizeStart())
+        event.stop()
+
+    def on_mouse_move(self, event: MouseMove) -> None:
+        """Handle drag movement."""
+        if self.dragging:
+            delta = event.screen_x - self._last_x
+            if delta != 0:
+                self.post_message(self.Resized(delta, event.screen_x))
+                self._last_x = event.screen_x
+            event.stop()
+
+    def on_mouse_up(self, event: MouseUp) -> None:
+        """Stop dragging."""
+        if self.dragging:
+            self.dragging = False
+            self.release_mouse()
+            self.post_message(self.ResizeEnd())
+            event.stop()
+
+    def render(self) -> Text:
+        """Render the divider."""
+        # Just a vertical line character
+        return Text("│", style=SQ_COLORS.primary if self.dragging else SQ_COLORS.border_subtle)
+
+
+# ============================================================================
+# RESIZABLE SIDEBAR CONTAINER
+# ============================================================================
+
+
+class ResizableSidebarContainer(Container):
+    """
+    Container that wraps a sidebar and provides resize functionality.
+
+    Features:
+    - Drag-to-resize with ResizableDivider
+    - Keyboard shortcuts (Ctrl+[ / Ctrl+])
+    - Min/max width constraints
+    - Collapse/expand toggle
+    """
+
+    DEFAULT_CSS = """
+    ResizableSidebarContainer {
+        height: 100%;
+        layout: horizontal;
+    }
+
+    ResizableSidebarContainer #rsb-sidebar {
+        height: 100%;
+        background: #000000;
+    }
+
+    ResizableSidebarContainer #rsb-sidebar.collapsed {
+        width: 0;
+        display: none;
+    }
+
+    ResizableSidebarContainer #rsb-divider {
+        width: 1;
+    }
+
+    ResizableSidebarContainer #rsb-divider.hidden {
+        display: none;
+    }
+    """
+
+    BINDINGS = [
+        Binding("ctrl+[", "shrink_sidebar", "Shrink", show=False),
+        Binding("ctrl+]", "expand_sidebar", "Expand", show=False),
+    ]
+
+    # State
+    sidebar_width: reactive[int] = reactive(80)
+    sidebar_visible: reactive[bool] = reactive(True)
+
+    # Config
+    min_width: int = 30
+    max_width: int = 150
+    resize_step: int = 10
+
+    def __init__(
+        self,
+        sidebar_content: Container,
+        min_width: int = 30,
+        max_width: int = 150,
+        initial_width: int = 80,
+        **kwargs,
+    ):
+        super().__init__(**kwargs)
+        self._sidebar_content = sidebar_content
+        self.min_width = min_width
+        self.max_width = max_width
+        self.sidebar_width = initial_width
+
+    def compose(self):
+        """Compose the resizable sidebar."""
+        # Sidebar container
+        with Container(id="rsb-sidebar"):
+            yield self._sidebar_content
+
+        # Divider
+        yield ResizableDivider(id="rsb-divider")
+
+    def on_mount(self) -> None:
+        """Initialize sidebar width."""
+        self._update_sidebar_width()
+
+    def watch_sidebar_width(self, width: int) -> None:
+        """Update sidebar width when changed."""
+        self._update_sidebar_width()
+
+    def watch_sidebar_visible(self, visible: bool) -> None:
+        """Toggle sidebar visibility."""
+        try:
+            sidebar = self.query_one("#rsb-sidebar")
+            divider = self.query_one("#rsb-divider")
+
+            if visible:
+                sidebar.remove_class("collapsed")
+                divider.remove_class("hidden")
+            else:
+                sidebar.add_class("collapsed")
+                divider.add_class("hidden")
+        except Exception:
+            pass
+
+    def _update_sidebar_width(self) -> None:
+        """Apply the current width to the sidebar."""
+        try:
+            sidebar = self.query_one("#rsb-sidebar")
+            sidebar.styles.width = self.sidebar_width
+        except Exception:
+            pass
+
+    def on_resizable_divider_resized(self, event: ResizableDivider.Resized) -> None:
+        """Handle divider drag."""
+        new_width = self.sidebar_width + event.delta_x
+        new_width = max(self.min_width, min(self.max_width, new_width))
+        self.sidebar_width = new_width
+
+    def action_shrink_sidebar(self) -> None:
+        """Shrink sidebar by step size."""
+        new_width = self.sidebar_width - self.resize_step
+        self.sidebar_width = max(self.min_width, new_width)
+
+    def action_expand_sidebar(self) -> None:
+        """Expand sidebar by step size."""
+        new_width = self.sidebar_width + self.resize_step
+        self.sidebar_width = min(self.max_width, new_width)
+
+    def toggle_sidebar(self) -> None:
+        """Toggle sidebar visibility."""
+        self.sidebar_visible = not self.sidebar_visible
+
+    def set_width(self, width: int) -> None:
+        """Set sidebar width directly."""
+        self.sidebar_width = max(self.min_width, min(self.max_width, width))
+
+    def get_width(self) -> int:
+        """Get current sidebar width."""
+        return self.sidebar_width
+
+
+# ============================================================================
+# SIDEBAR TAB BAR
+# ============================================================================
+
+
+class SidebarTabBar(Static):
+    """
+    Tab bar for switching between sidebar panels.
+
+    SuperQode style: Minimal tabs with purple active indicator.
+    """
+
+    DEFAULT_CSS = """
+    SidebarTabBar {
+        height: 2;
+        background: #0a0a0a;
+        border-bottom: solid #1a1a1a;
+        padding: 0;
+    }
+    """
+
+    class TabSelected(Message):
+        """Posted when a tab is selected."""
+
+        def __init__(self, tab_id: str, index: int) -> None:
+            self.tab_id = tab_id
+            self.index = index
+            super().__init__()
+
+    active_tab: reactive[int] = reactive(0)
+
+    def __init__(self, tabs: list[str], **kwargs):
+        super().__init__("", **kwargs)
+        self._tabs = tabs
+
+    def watch_active_tab(self, index: int) -> None:
+        """Update display when active tab changes."""
+        self.refresh()
+        if 0 <= index < len(self._tabs):
+            self.post_message(self.TabSelected(self._tabs[index].lower(), index))
+
+    def select_tab(self, index: int) -> None:
+        """Select a tab by index."""
+        if 0 <= index < len(self._tabs):
+            self.active_tab = index
+
+    def select_tab_by_name(self, name: str) -> None:
+        """Select a tab by name."""
+        name_lower = name.lower()
+        for i, tab in enumerate(self._tabs):
+            if tab.lower() == name_lower:
+                self.active_tab = i
+                break
+
+    def render(self) -> Text:
+        """Render the tab bar."""
+        text = Text()
+
+        for i, tab in enumerate(self._tabs):
+            is_active = i == self.active_tab
+
+            # Tab separator
+            if i > 0:
+                text.append(" ", style="")
+
+            # Tab name (abbreviated for space)
+            short_name = tab[:3] if len(tab) > 4 else tab
+
+            if is_active:
+                text.append(f"[{short_name}]", style=f"bold {SQ_COLORS.primary}")
+            else:
+                text.append(f" {short_name} ", style=SQ_COLORS.text_dim)
+
+        return text
+
+    def on_click(self, event) -> None:
+        """Handle click to select tab."""
+        # Calculate which tab was clicked based on x position
+        # Each tab is roughly 5 characters wide
+        tab_width = 5
+        index = event.x // tab_width
+        if 0 <= index < len(self._tabs):
+            self.active_tab = index
+
+
+# ============================================================================
+# EXPORTS
+# ============================================================================
+
+__all__ = [
+    "ResizableDivider",
+    "ResizableSidebarContainer",
+    "SidebarTabBar",
+]