nexus-tui 0.1.13__py3-none-any.whl → 0.1.15__py3-none-any.whl

nexus/style.tcss

@@ -17,13 +17,12 @@ Screen {
 }
 
 #header-left {
-    width: auto;
-    content-align: left middle;
+    width: 30%;
+    content-align: center middle;
 }
 
 #tool-search {
-    width: 60%;
-    margin-left: 2;
+    width: 70%;
     padding: 0 1;
     height: 3;
     /* Colors/Borders moved to theme sections */
@@ -35,8 +34,8 @@ Screen {
     text-style: bold;
 }
 
-/* Main Container */
-#main-container {
+/* Main Container (implicit in ToolBrowser now) */
+ToolBrowser {
     height: 1fr;
     /* Borders defined in theme */
 }
@@ -53,6 +52,15 @@ Screen {
     height: 100%;
 }
 
+/* --- RESPONSIVE / COMPACT MODE --- */
+ToolBrowser.compact #left-pane {
+    display: none;
+}
+
+ToolBrowser.compact #right-pane {
+    width: 100%;
+}
+
 .pane-header {
     height: 1;
     text-style: underline;
@@ -97,13 +105,6 @@ ListItem {
     margin-right: 1;
 }
 
-#custom-footer {
-    height: 4;
-    dock: bottom;
-    padding: 0 1;
-}
-
-
 .hidden {
     display: none;
 }
@@ -134,7 +135,7 @@ ListItem {
 
 .theme-dark #header, 
 .theme-dark .pane-header, 
-.theme-dark #footer-container {
+.theme-dark NexusFooter {
     background: #101010;
     color: #c0caf5;
 }
@@ -145,7 +146,7 @@ ListItem {
 }
 
 .theme-dark #header-right { border: solid #c0caf5; }
-.theme-dark #main-container { border-top: solid #c0caf5; } /* removed bottom border */
+.theme-dark ToolBrowser { border-top: solid #c0caf5; } /* removed bottom border */
 .theme-dark #left-pane { border-right: solid #c0caf5; }
 .theme-dark .pane-header-container { border-bottom: solid #c0caf5; }
 .theme-dark #tool-description { color: #bb9af7; border-top: solid #c0caf5; }
@@ -189,13 +190,13 @@ ListItem {
 
 .theme-storm #header, 
 .theme-storm .pane-header, 
-.theme-storm #footer-container {
+.theme-storm NexusFooter {
     background: #24283b;
     color: #c0caf5;
 }
 
 .theme-storm #header-right { border: solid #c0caf5; }
-.theme-storm #main-container { border-top: solid #c0caf5; } /* removed bottom border */
+.theme-storm ToolBrowser { border-top: solid #c0caf5; } /* removed bottom border */
 .theme-storm #left-pane { border-right: solid #c0caf5; }
 .theme-storm .pane-header-container { border-bottom: solid #c0caf5; }
 .theme-storm #tool-description { color: #bb9af7; border-top: solid #c0caf5; }
@@ -240,13 +241,13 @@ ListItem {
 
 .theme-light #header, 
 .theme-light .pane-header, 
-.theme-light #footer-container {
+.theme-light NexusFooter {
     background: #d5d6db;
     color: #343b58;
 }
 
 .theme-light #header-right { border: solid #343b58; }
-.theme-light #main-container { border-top: solid #343b58; } /* removed bottom border */
+.theme-light ToolBrowser { border-top: solid #343b58; } /* removed bottom border */
 .theme-light #left-pane { border-right: solid #343b58; }
 .theme-light .pane-header-container { border-bottom: solid #343b58; }
 .theme-light #tool-description { color: #8c4351; border-top: solid #343b58; }
@@ -342,7 +343,7 @@ ThemePicker {
 
 
 /* --- NEW FOOTER --- */
-#footer-container {
+NexusFooter {
     height: 3; 
     dock: bottom;
     padding: 0 1; 
@@ -366,6 +367,7 @@ ThemePicker {
     padding: 0 1;
     text-style: bold;
     margin-right: 1;      /* Add space between badge and desc */
+    width: auto;
 }
 
 .key-desc {
@@ -498,3 +500,50 @@ ThemePicker {
     margin-top: 1;
     height: 3;
 }
+
+/* --- POLISH: FAVORITES & FOCUS --- */
+
+/* Favorites Styling (Generic) */
+.list-item.--favorite {
+    color: #ff9e64; /* Orange/Gold for favs */
+    text-style: bold;
+}
+
+/* Pane Headers - De-emphasized */
+.pane-header {
+    color: #565f89;
+    text-style: none; /* Remove underline */
+}
+.pane-header-right {
+    color: #565f89;
+    text-style: italic;
+}
+
+/* Focused Pane Header - Re-emphasize when active */
+#right-pane:focus-within .pane-header,
+#left-pane:focus-within .pane-header {
+    color: $text;
+    text-style: bold;
+}
+
+/* Pane Focus Indication (Stronger Borders + Header Highlight) */
+.theme-dark ToolBrowser:focus-within {
+     border-top: thick #7aa2f7; 
+}
+.theme-dark #left-pane:focus-within {
+    border-right: thick #7aa2f7;
+}
+
+.theme-storm ToolBrowser:focus-within {
+     border-top: thick #bb9af7; 
+}
+.theme-storm #left-pane:focus-within {
+    border-right: thick #bb9af7;
+}
+
+.theme-light ToolBrowser:focus-within {
+     border-top: thick #3d59a1; 
+}
+.theme-light #left-pane:focus-within {
+    border-right: thick #3d59a1;
+}

nexus/widgets/footer.py

@@ -0,0 +1,108 @@
+"""Footer widget for the Nexus application.
+
+Displays keybindings and status information, adapting to available width.
+"""
+from typing import Any
+from textual.app import ComposeResult
+from textual.widgets import Label, Static
+
+
+from textual.message import Message
+
+class KeyBadge(Static):
+    """A badge displaying a key binding."""
+
+    DEFAULT_CSS = """
+    KeyBadge {
+        layout: horizontal;
+        width: auto;
+        height: 1;
+        margin-right: 2;
+    }
+    KeyBadge:hover {
+        background: $primary;
+        color: $text;
+    }
+    """
+    
+    class Pressed(Message):
+        """Message sent when the badge is clicked."""
+        def __init__(self, action: str) -> None:
+            self.action = action
+            super().__init__()
+
+    def __init__(self, key: str, description: str, action: str) -> None:
+        super().__init__()
+        self.key = key
+        self.description = description
+        self.action_name = action
+
+    def compose(self) -> ComposeResult:
+        yield Label(self.key, classes="key-badge")
+        yield Label(self.description, classes="key-desc")
+        
+    def on_click(self) -> None:
+        self.post_message(self.Pressed(self.action_name))
+
+
+class FooterSection(Static):
+    """A section of the footer grouping related keys."""
+    
+    DEFAULT_CSS = """
+    FooterSection {
+        layout: horizontal;
+        width: auto;
+        height: 100%;
+        padding-right: 2;
+        content-align: center middle;
+    }
+    """
+
+    def __init__(self, title: str) -> None:
+        super().__init__()
+        self.title_text = title
+
+    def compose(self) -> ComposeResult:
+        yield Label(self.title_text, classes="footer-label")
+
+
+class NexusFooter(Static):
+    """The main application footer.
+    
+    Displays a minimal set of essential keybindings (Progressive Disclosure).
+    """
+
+    DEFAULT_CSS = """
+    NexusFooter {
+        height: 3;
+        dock: bottom;
+        padding: 0 2;
+        layout: horizontal;
+        background: $surface;
+        content-align: center middle; 
+    }
+
+    .key-separator {
+        width: 4;
+        content-align: center middle;
+        color: #565f89;
+    }
+    """
+
+    def __init__(self, key_defs: list[tuple[str, str, str]] | None = None, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        if key_defs is None:
+             self.key_defs = [
+                ("Enter", "Select", "launch_current"),
+                ("Ctrl+F", "Favorite", "toggle_favorite"),
+                ("Ctrl+C", "Quit", "app.quit"),
+                ("Ctrl+H", "Help", "show_help"),
+             ]
+        else:
+            self.key_defs = key_defs
+
+    def compose(self) -> ComposeResult:
+        for i, (key, desc, action) in enumerate(self.key_defs):
+            yield KeyBadge(key, desc, action)
+            if i < len(self.key_defs) - 1:
+                yield Label("    ", classes="key-separator")

nexus/widgets/tool_browser.py

@@ -0,0 +1,253 @@
+"""Widget for browsing tools by category.
+
+Encapsulates the split-pane layout with Category list and Tool list.
+"""
+
+from typing import cast
+
+from textual.app import ComposeResult
+from textual.containers import Horizontal, Vertical
+from textual.message import Message
+from textual.reactive import reactive
+from textual.widget import Widget
+from textual.widgets import Label, ListView
+
+from nexus.config import get_tools
+from nexus.models import Tool
+from nexus.widgets.tool_list_item import CategoryListItem, ToolListItem
+
+
+class ToolBrowser(Widget):
+    """A dual-pane browser for categories and tools."""
+
+    DEFAULT_CSS = """
+    ToolBrowser {
+        height: 1fr;
+        layout: horizontal;
+    }
+    
+    /* Re-use existing ID-based styles from style.tcss via matching IDs or classes */
+    /* We will use matching IDs to keep style.tcss compatible without huge changes yet */
+    """
+
+    class ToolSelected(Message):
+        """Message posted when a tool is selected (Enter pressed)."""
+
+        def __init__(self, tool: Tool) -> None:
+            self.tool = tool
+            super().__init__()
+
+    class ToolHighlighted(Message):
+        """Message posted when a tool is highlighted (for description updates)."""
+
+        def __init__(self, tool: Tool) -> None:
+            self.tool = tool
+            super().__init__()
+
+    search_query = reactive("")
+
+    def compose(self) -> ComposeResult:
+        """Compose the dual-pane layout."""
+        # Left Pane: Categories
+        with Vertical(id="left-pane"):
+            yield Label("Categories", classes="pane-header")
+            yield ListView(id="category-list")
+
+        # Right Pane: Tools
+        with Vertical(id="right-pane"):
+            with Horizontal(classes="pane-header-container"):
+                yield Label("Toolbox", classes="pane-header")
+                yield Label("Tip: Ctrl+H for controls", classes="pane-header-right")
+            
+            yield ListView(id="tool-list")
+            yield Label(
+                "No tools found", id="tools-empty", classes="empty-state hidden"
+            )
+
+    def on_mount(self) -> None:
+        """Initialize lists."""
+        self.populate_categories()
+        # Default focus
+        self.query_one("#category-list").focus()
+
+    def watch_search_query(self, new_value: str) -> None:
+        """Filter tools when search query changes."""
+        if new_value:
+            # Auto-select ALL category if searching
+            self.select_all_category()
+            self.refresh_tools()
+        else:
+            self.refresh_tools()
+
+    def select_all_category(self) -> None:
+        """Selects the 'ALL' category."""
+        category_list = self.query_one("#category-list", ListView)
+        for idx, child in enumerate(category_list.children):
+            if isinstance(child, CategoryListItem) and child.category_id == "ALL":
+                if category_list.index != idx:
+                    category_list.index = cast(int | None, idx) # generic fix
+                break
+
+    def populate_categories(self) -> None:
+        """Populate the category list."""
+        category_list = self.query_one("#category-list", ListView)
+        category_list.clear()
+
+        tools = get_tools()
+        categories = sorted(list(set(t.category for t in tools)))
+
+        category_list.append(CategoryListItem("FAVORITES"))
+        category_list.append(CategoryListItem("ALL"))
+
+        for category in categories:
+            category_list.append(CategoryListItem(category))
+
+        # Default to ALL (index 1)
+        category_list.index = 1
+        # Trigger initial tool population
+        self.populate_tools("ALL")
+
+    def populate_tools(self, category: str, filter_text: str = "") -> None:
+        """Populate the tool list."""
+        tool_list = self.query_one("#tool-list", ListView)
+        tool_list.clear()
+
+        tools = get_tools()
+
+        # Filter by Category
+        if category == "ALL":
+            filtered_tools = tools
+        elif category == "FAVORITES":
+            # We need to access app state for favorites.
+            # Using a simplified approach: check if available in app
+             from nexus.app import NexusApp
+             if isinstance(self.app, NexusApp):
+                 favs = self.app.container.state_manager.get_favorites()
+                 filtered_tools = [t for t in tools if t.command in favs]
+             else:
+                 filtered_tools = []
+        else:
+            filtered_tools = [t for t in tools if t.category == category]
+
+        # Filter by Text
+        if filter_text:
+            filtered_tools = [
+                t
+                for t in filtered_tools
+                if filter_text.lower() in t.label.lower()
+                or filter_text.lower() in t.description.lower()
+            ]
+
+        # Update UI
+        empty_lbl = self.query_one("#tools-empty", Label)
+        
+        if filtered_tools:
+            tool_list.display = True
+            empty_lbl.add_class("hidden")
+            tool_list.index = 0
+        else:
+            tool_list.display = False
+            empty_lbl.remove_class("hidden")
+            if filter_text:
+                empty_lbl.update(f"No tools matching '{filter_text}'")
+            else:
+                empty_lbl.update(f"No tools in category '{category}'")
+
+        # Render Items
+        for i, tool in enumerate(filtered_tools):
+            is_fav = False
+            from nexus.app import NexusApp
+            if isinstance(self.app, NexusApp):
+                is_fav = self.app.container.state_manager.is_favorite(tool.command)
+                
+            tool_list.append(ToolListItem(tool, is_favorite=is_fav))
+
+    def refresh_tools(self) -> None:
+        """Refresh (re-populate) the currently viewed category."""
+        category_list = self.query_one("#category-list", ListView)
+        if category_list.highlighted_child:
+            item = category_list.highlighted_child
+            if isinstance(item, CategoryListItem):
+                self.populate_tools(item.category_id, filter_text=self.search_query)
+
+    # --- Event Handlers ---
+
+    def on_list_view_highlighted(self, event: ListView.Highlighted) -> None:
+        if event.list_view.id == "category-list":
+            # Update tool list when category changes
+            if isinstance(event.item, CategoryListItem):
+                self.populate_tools(event.item.category_id, filter_text=self.search_query)
+        
+        elif event.list_view.id == "tool-list":
+            # Notify parent to update description
+            if isinstance(event.item, ToolListItem):
+                self.post_message(self.ToolHighlighted(event.item.tool_info))
+
+    def on_list_view_selected(self, event: ListView.Selected) -> None:
+        if event.list_view.id == "category-list":
+            # Move focus to tool list
+            self.query_one("#tool-list").focus()
+            
+            # Ensure the first item is selected in tool list
+            tool_list = self.query_one("#tool-list", ListView)
+            if tool_list.children:
+                tool_list.index = 0
+
+        elif event.list_view.id == "tool-list":
+            # Launch tool
+            if isinstance(event.item, ToolListItem):
+                self.post_message(self.ToolSelected(event.item.tool_info))
+
+    # --- Public Control Methods (for parent screen bindings) ---
+
+    def focus_next(self) -> None:
+        """Simulate down arrow."""
+        if self.query_one("#category-list").has_focus:
+            self._move_list_cursor("#category-list", 1)
+        elif self.query_one("#tool-list").has_focus:
+            self._move_list_cursor("#tool-list", 1)
+
+    def focus_prev(self) -> None:
+        """Simulate up arrow."""
+        if self.query_one("#category-list").has_focus:
+            self._move_list_cursor("#category-list", -1)
+        elif self.query_one("#tool-list").has_focus:
+            self._move_list_cursor("#tool-list", -1)
+
+    def _move_list_cursor(self, list_id: str, delta: int) -> None:
+        lst = self.query_one(list_id, ListView)
+        if lst.index is None:
+            lst.index = 0
+        else:
+            new_index = lst.index + delta
+            # Clamp
+            new_index = max(0, min(len(lst.children) - 1, new_index))
+            lst.index = new_index
+
+    def focus_right(self) -> None:
+        """Switch to tools."""
+        if self.query_one("#category-list").has_focus:
+             self.query_one("#tool-list").focus()
+
+    def focus_left(self) -> None:
+        """Switch to categories."""
+        if self.query_one("#tool-list").has_focus:
+            self.query_one("#category-list").focus()
+
+    def get_tool_at_index(self, index: int) -> Tool | None:
+        """Return tool at specific list index (for 1-9 shortcuts)."""
+        tool_list = self.query_one("#tool-list", ListView)
+        if 0 <= index < len(tool_list.children):
+            item = tool_list.children[index]
+            if isinstance(item, ToolListItem):
+                return item.tool_info
+        return None
+
+    def get_current_selection(self) -> Tool | None:
+        """Return currently selected tool."""
+        tool_list = self.query_one("#tool-list", ListView)
+        if tool_list.highlighted_child:
+            item = tool_list.highlighted_child
+            if isinstance(item, ToolListItem):
+                return item.tool_info
+        return None

nexus/widgets/tool_list_item.py

@@ -16,7 +16,6 @@ class ToolItem(Static):
     def __init__(
         self,
         tool_info: Tool,
-        hint: str = "",
         is_favorite: bool = False,
         **kwargs: Any,
     ):
@@ -24,13 +23,11 @@ class ToolItem(Static):
 
         Args:
             tool_info: The Tool model containing tool details.
-            hint: Optional numeric hint (e.g. '1').
             is_favorite: Whether the tool is marked as a favorite.
             **kwargs: Additional arguments passed to the Static widget.
         """
         super().__init__(**kwargs)
         self.tool_info = tool_info
-        self.hint = hint
         self.is_favorite = is_favorite
         self.can_focus = True
 
@@ -40,10 +37,9 @@ class ToolItem(Static):
         Returns:
             A string representation of the tool label prefixed with '> '.
         """
-        hint_str = f"[bold magenta]{self.hint}[/] " if self.hint else ""
         fav_str = "[bold yellow]★[/] " if self.is_favorite else ""
         label = self.tool_info.label
-        return f"{hint_str}{fav_str}> {label} | [dim]{self.tool_info.description}[/]"
+        return f"{fav_str}> [bold]{label}[/] | [#565f89]{self.tool_info.description}[/]"
 
     def on_mount(self) -> None:
         """Called when the widget is mounted.
@@ -51,6 +47,8 @@ class ToolItem(Static):
         Adds specific CSS classes for styling.
         """
         self.add_class("list-item")
+        if self.is_favorite:
+            self.add_class("--favorite")
         self.add_class(f"category-{self.tool_info.category}")
 
 
@@ -105,7 +103,6 @@ class ToolListItem(ListItem):
     def __init__(
         self,
         tool_info: Tool,
-        hint: str = "",
         is_favorite: bool = False,
         **kwargs: Any,
     ):
@@ -113,13 +110,12 @@ class ToolListItem(ListItem):
 
         Args:
             tool_info: The Tool model.
-            hint: Optional numeric hint.
             is_favorite: Whether the tool is a favorite.
             **kwargs: Additional arguments passed to the ListItem.
         """
         self.tool_info = tool_info
         super().__init__(
-            ToolItem(tool_info, hint=hint, is_favorite=is_favorite), **kwargs
+            ToolItem(tool_info, is_favorite=is_favorite), **kwargs
         )