@anastops/cli 1.0.0 → 1.2.0

package/ranger-tui/ranger_tui/styles/ranger.tcss

@@ -0,0 +1,254 @@
+/* Ranger TUI - Theme-aware responsive design */
+
+/* ============ Global ============ */
+
+Screen {
+    background: $background;
+    layout: vertical;
+}
+
+/* ============ Main Layout ============ */
+
+#main {
+    width: 100%;
+    height: 1fr;
+    layout: horizontal;
+    padding: 0 1;
+}
+
+/* ============ Tables ============ */
+
+DataTable {
+    width: 1fr;
+    height: 100%;
+    background: $surface;
+    border: round $secondary-darken-2;
+    overflow-x: hidden;
+}
+
+DataTable > .datatable--header {
+    text-style: bold;
+    color: $primary;
+    background: $panel;
+}
+
+DataTable > .datatable--cursor {
+    background: $primary-darken-3;
+}
+
+DataTable:focus > .datatable--cursor {
+    background: $primary-darken-1;
+}
+
+DataTable > .datatable--even-row {
+    background: $surface;
+}
+
+DataTable > .datatable--odd-row {
+    background: $background;
+}
+
+/* ============ Tabs ============ */
+
+TabbedContent {
+    width: 1fr;
+    height: 100%;
+}
+
+ContentSwitcher {
+    height: 1fr;
+}
+
+Tabs {
+    background: $panel;
+    dock: top;
+    height: 3;
+}
+
+Tab {
+    color: $foreground-muted;
+    padding: 0 2;
+}
+
+Tab:hover {
+    color: $foreground;
+    background: $surface;
+}
+
+Tab.-active {
+    color: $primary;
+    text-style: bold;
+    background: $surface;
+}
+
+TabPane {
+    height: 1fr;
+    padding: 0;
+}
+
+/* ============ RichLog ============ */
+
+RichLog {
+    width: 100%;
+    height: 100%;
+    background: $surface;
+    border: round $secondary-darken-2;
+    padding: 1;
+    scrollbar-color: $secondary;
+    scrollbar-color-hover: $primary;
+}
+
+/* ============ Modals ============ */
+
+ModalScreen {
+    align: center middle;
+}
+
+#modal, #dialog {
+    width: 60;
+    height: auto;
+    background: $surface;
+    border: round $primary;
+    padding: 1 2;
+}
+
+#modal-title, #title {
+    text-style: bold;
+    color: $primary;
+    text-align: center;
+    margin-bottom: 1;
+}
+
+#modal Label, #dialog Label {
+    color: $foreground-muted;
+    margin-top: 1;
+}
+
+#modal Input, #dialog Input {
+    margin-bottom: 1;
+}
+
+#modal Select, #dialog Select {
+    margin-bottom: 1;
+}
+
+#modal-buttons, #buttons {
+    margin-top: 1;
+    align: center middle;
+    layout: horizontal;
+}
+
+#modal-buttons Button, #buttons Button {
+    margin: 0 1;
+    min-width: 12;
+}
+
+/* ============ Inputs ============ */
+
+Input {
+    background: $background;
+    border: tall $secondary-darken-2;
+    color: $foreground;
+}
+
+Input:focus {
+    border: tall $primary;
+}
+
+Input.-invalid {
+    border: tall $error;
+}
+
+/* ============ Selects ============ */
+
+Select {
+    background: $background;
+    border: tall $secondary-darken-2;
+}
+
+Select:focus {
+    border: tall $primary;
+}
+
+SelectCurrent {
+    background: $background;
+}
+
+SelectOverlay {
+    background: $surface;
+    border: round $secondary-darken-2;
+}
+
+/* ============ Buttons ============ */
+
+Button {
+    background: $secondary;
+    color: $foreground;
+    border: none;
+}
+
+Button:hover {
+    background: $secondary-lighten-1;
+}
+
+Button.-primary {
+    background: $primary;
+    color: $background;
+}
+
+Button.-primary:hover {
+    background: $primary-lighten-1;
+}
+
+/* ============ Footer ============ */
+
+Footer {
+    background: $panel;
+}
+
+Footer > .footer--key {
+    background: $secondary;
+    color: $primary;
+}
+
+Footer > .footer--description {
+    color: $foreground-muted;
+}
+
+/* ============ Scrollbars ============ */
+
+* {
+    scrollbar-color: $secondary-darken-2;
+    scrollbar-color-hover: $secondary;
+    scrollbar-color-active: $primary;
+}
+
+/* ============ Status Classes ============ */
+
+.status-active {
+    color: $accent;
+}
+
+.status-success {
+    color: $success;
+}
+
+.status-error {
+    color: $error;
+}
+
+.status-warning {
+    color: $warning;
+}
+
+.status-muted {
+    color: $foreground-muted;
+}
+
+/* ============ Notifications ============ */
+
+Toast {
+    background: $surface;
+    border: round $secondary-darken-2;
+    color: $foreground;
+}

package/ranger-tui/ranger_tui/theme.py

@@ -0,0 +1,93 @@
+"""
+Ranger TUI theme definition.
+"""
+
+from textual.theme import Theme
+
+# Custom theme based on Tokyo Night with orchestration-focused colors
+RANGER_THEME = Theme(
+    name="ranger",
+    primary="#7aa2f7",      # Blue - primary actions
+    secondary="#565f89",    # Muted - secondary elements
+    accent="#bb9af7",       # Purple - highlights
+    foreground="#a9b1d6",   # Light text
+    background="#1a1b26",   # Dark background
+    success="#9ece6a",      # Green - completed
+    warning="#e0af68",      # Orange - warnings
+    error="#f7768e",        # Red - errors
+    surface="#24283b",      # Elevated surfaces
+    panel="#16161e",        # Sidebar/panels
+    dark=True,
+)
+
+# Status symbols for consistent display
+STATUS_SYMBOLS = {
+    # Session status
+    "active": "●",
+    "completed": "✓",
+    "archived": "◌",
+    
+    # Task status
+    "pending": "○",
+    "queued": "◐",
+    "running": "●",
+    "failed": "✗",
+    "cancelled": "⊘",
+    
+    # Agent status
+    "idle": "○",
+    "working": "●",
+}
+
+
+def format_status(status: str, include_label: bool = True) -> str:
+    """Format status with symbol and optional label."""
+    symbol = STATUS_SYMBOLS.get(status, "?")
+    if include_label:
+        return f"{symbol} {status.capitalize()}"
+    return symbol
+
+
+def get_status_class(status: str) -> str:
+    """Get CSS class for status styling."""
+    status_classes = {
+        "active": "status-active",
+        "running": "status-active",
+        "working": "status-active",
+        "completed": "status-success",
+        "archived": "status-muted",
+        "pending": "status-muted",
+        "idle": "status-muted",
+        "queued": "status-warning",
+        "failed": "status-error",
+        "cancelled": "status-error",
+    }
+    return status_classes.get(status, "")
+
+
+# Model display names with versions
+MODEL_DISPLAY_NAMES = {
+    # Claude models
+    "claude-opus": "Opus 4",
+    "claude-sonnet": "Sonnet 4",
+    "claude-haiku": "Haiku 3.5",
+    # Gemini models
+    "gemini-default": "Gemini 2.5",
+    "gemini-2.5-pro": "Gemini 2.5 Pro",
+    "gemini-2.5-flash": "Gemini 2.5 Flash",
+    "gemini-3-pro": "Gemini 3 Pro",
+    # OpenAI models
+    "gpt-5": "GPT-5",
+    "gpt-5-codex": "GPT-5 Codex",
+    "gpt-5.2": "GPT-5.2",
+    # Cursor models
+    "sonnet-4.5": "Sonnet 4.5",
+    "opus-4.5": "Opus 4.5",
+    # Grok
+    "grok-default": "Grok 3",
+}
+
+
+def format_model(model: str) -> str:
+    """Format model name with version for display."""
+    return MODEL_DISPLAY_NAMES.get(model, model)

package/ranger-tui/ranger_tui/widgets/__init__.py

@@ -0,0 +1,23 @@
+"""
+Custom widgets for Ranger TUI.
+"""
+
+from ranger_tui.widgets.topbar import TopBar
+from ranger_tui.widgets.sidebar import Sidebar
+from ranger_tui.widgets.logo import Logo, LogoBanner, LogoSplash
+from ranger_tui.widgets.accessible import (
+    AccessibleWidget,
+    AccessibleDataTable,
+    AccessibilityChangedMessage,
+)
+
+__all__ = [
+    "TopBar",
+    "Sidebar",
+    "Logo",
+    "LogoBanner",
+    "LogoSplash",
+    "AccessibleWidget",
+    "AccessibleDataTable",
+    "AccessibilityChangedMessage",
+]

package/ranger-tui/ranger_tui/widgets/accessible.py

@@ -0,0 +1,176 @@
+"""
+Accessible widget mixin for enhanced accessibility support.
+
+Provides accessibility features to widgets:
+- ARIA-like metadata attachment
+- Screen reader announcements
+- Keyboard help generation
+- Status announcements for dynamic updates
+"""
+
+from typing import Optional, Any, Dict
+from textual.widget import Widget
+from textual.message import Message
+
+from ranger_tui.accessibility import (
+    AccessibilityMetadata,
+    AccessibilityHelper,
+    get_widget_metadata,
+)
+
+
+class AccessibilityChangedMessage(Message):
+    """Message for accessibility state changes."""
+
+    def __init__(self, announcement: str) -> None:
+        super().__init__()
+        self.announcement = announcement
+
+
+class AccessibleWidget(Widget):
+    """Mixin for accessible widgets with ARIA-like metadata."""
+
+    _accessibility_metadata: Optional[AccessibilityMetadata] = None
+    _previous_announcement: Optional[str] = None
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        # Load metadata on initialization if available
+        if self.id:
+            self._accessibility_metadata = get_widget_metadata(self.id)
+
+    def set_accessibility_metadata(
+        self,
+        metadata: AccessibilityMetadata,
+    ) -> None:
+        """Set accessibility metadata for this widget."""
+        self._accessibility_metadata = metadata
+
+    def get_accessibility_metadata(self) -> Optional[AccessibilityMetadata]:
+        """Get accessibility metadata for this widget."""
+        return self._accessibility_metadata
+
+    def get_accessibility_label(self) -> str:
+        """Get the accessibility label for this widget."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.label
+        return self.id or self.__class__.__name__
+
+    def get_accessibility_announcement(self) -> str:
+        """Get a complete accessibility announcement for this widget."""
+        if not self._accessibility_metadata:
+            return ""
+        return self._accessibility_metadata.to_announcement()
+
+    def get_keyboard_help(self) -> str:
+        """Get keyboard help for this widget."""
+        if not self._accessibility_metadata:
+            return ""
+        return AccessibilityHelper.announce_keyboard_help(self.id or "")
+
+    def announce_status_change(
+        self,
+        action: str,
+        details: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        """Announce a status change for accessibility."""
+        from ranger_tui.accessibility import format_accessibility_announcement
+
+        announcement = format_accessibility_announcement(action, details)
+        self.post_message(AccessibilityChangedMessage(announcement))
+        self._previous_announcement = announcement
+
+    def get_role(self) -> str:
+        """Get the ARIA-like role for this widget."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.role.value
+        return "widget"
+
+    def get_help_text(self) -> str:
+        """Get the help text for this widget."""
+        if self._accessibility_metadata and self._accessibility_metadata.help_text:
+            return self._accessibility_metadata.help_text
+        return ""
+
+    def is_landmark(self) -> bool:
+        """Check if this widget is a landmark region."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.landmark is not None
+        return False
+
+    def get_landmark_name(self) -> Optional[str]:
+        """Get the landmark name if this is a landmark region."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.landmark
+        return None
+
+    def should_be_hidden_from_screen_readers(self) -> bool:
+        """Check if this widget should be hidden from screen readers."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.aria_hidden
+        return False
+
+    def is_disabled(self) -> bool:
+        """Check if this widget is disabled."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.aria_disabled
+        return False
+
+    def is_loading(self) -> bool:
+        """Check if this widget is loading or processing."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.aria_busy
+        return False
+
+    def get_live_region_politeness(self) -> str:
+        """Get the ARIA live region politeness level."""
+        if self._accessibility_metadata and self._accessibility_metadata.aria_live:
+            return self._accessibility_metadata.aria_live
+        return "off"
+
+    def should_announce_all_changes(self) -> bool:
+        """Check if all widget changes should be announced."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.aria_atomic
+        return False
+
+
+class AccessibleDataTable(AccessibleWidget):
+    """Accessible data table widget with ARIA-like metadata."""
+
+    def get_table_description(self) -> str:
+        """Get description of the entire table."""
+        if self._accessibility_metadata:
+            return self._accessibility_metadata.description or ""
+        return ""
+
+    def get_column_headers_announcement(self) -> str:
+        """Get announcement of all column headers."""
+        # This should be implemented by subclasses
+        return ""
+
+    def get_current_row_announcement(self, row_index: int) -> str:
+        """Get announcement for the current row."""
+        # This should be implemented by subclasses
+        return ""
+
+    def announce_row_selection(self, row_index: int) -> None:
+        """Announce row selection."""
+        announcement = f"Row {row_index + 1} selected. {self.get_current_row_announcement(row_index)}"
+        self.post_message(AccessibilityChangedMessage(announcement))
+
+    def announce_navigation(self, direction: str, row_index: int) -> None:
+        """Announce navigation within the table."""
+        direction_text = "down" if direction == "down" else "up"
+        announcement = (
+            f"Moved {direction_text} to row {row_index + 1}. "
+            f"{self.get_current_row_announcement(row_index)}"
+        )
+        self.post_message(AccessibilityChangedMessage(announcement))
+
+
+__all__ = [
+    "AccessibleWidget",
+    "AccessibleDataTable",
+    "AccessibilityChangedMessage",
+]