claudechic 0.2.2__py3-none-any.whl → 0.3.1__py3-none-any.whl

claudechic/widgets/__init__.py

@@ -1,9 +1,27 @@
-"""Textual widgets for Claude Code UI."""
+"""Textual widgets for Claude Code UI.
 
-from claudechic.cursor import ClickableMixin
-from claudechic.widgets.button import Button
-from claudechic.widgets.indicators import CPUBar, ContextBar
-from claudechic.widgets.chat import (
+Re-exports all widgets from submodules for backward compatibility.
+"""
+
+# Base classes and mixins
+from claudechic.widgets.base import (
+    ClickableMixin,
+    PointerMixin,
+    CopyButton,
+    CopyableMixin,
+    ToolWidget,
+)
+
+# Primitives
+from claudechic.widgets.primitives import (
+    Button,
+    QuietCollapsible,
+    AutoHideScroll,
+    Spinner,
+)
+
+# Content widgets
+from claudechic.widgets.content import (
     ChatMessage,
     ChatInput,
     ThinkingIndicator,
@@ -11,53 +29,85 @@ from claudechic.widgets.chat import (
     ErrorMessage,
     SystemInfo,
     ChatAttachment,
-    Spinner,
-)
-from claudechic.widgets.tools import (
     ToolUseWidget,
     TaskWidget,
     AgentToolWidget,
     AgentListWidget,
     ShellOutputWidget,
     EditPlanRequested,
+    DiffWidget,
+    TodoWidget,
+    TodoPanel,
+)
+
+# Input widgets
+from claudechic.widgets.input import TextAreaAutoComplete, HistorySearch
+
+# Layout widgets
+from claudechic.widgets.layout import (
+    ChatView,
+    AgentItem,
+    AgentSection,
+    WorktreeItem,
+    PlanItem,
+    PlanSection,
+    SidebarSection,
+    SidebarItem,
+    HamburgerButton,
+    SessionItem,
+    AutoEditLabel,
+    ModelLabel,
+    StatusFooter,
+    IndicatorWidget,
+    CPUBar,
+    ContextBar,
+    ProcessIndicator,
+    ProcessPanel,
+    ProcessItem,
 )
-from claudechic.widgets.diff import DiffWidget
-from claudechic.widgets.todo import TodoWidget, TodoPanel
+
+# Base re-exports (ClickableLabel used by layout widgets)
+from claudechic.widgets.base import ClickableLabel
+
+# Data classes (re-exported for convenience)
+from claudechic.processes import BackgroundProcess
+
+# Report widgets
+from claudechic.widgets.reports import UsageReport, ContextReport
+
+# Modal screens
+from claudechic.widgets.modals import ProfileModal, ProcessModal
+
+# Prompts
 from claudechic.widgets.prompts import (
     BasePrompt,
     SelectionPrompt,
     QuestionPrompt,
-    SessionItem,
-)
-from claudechic.widgets.model_prompt import ModelPrompt
-from claudechic.widgets.autocomplete import TextAreaAutoComplete
-from claudechic.widgets.agents import (
-    AgentItem,
-    AgentSidebar,
-    WorktreeItem,
-    PlanButton,
-    HamburgerButton,
+    ModelPrompt,
+    WorktreePrompt,
+    UncommittedChangesPrompt,
 )
-from claudechic.widgets.scroll import AutoHideScroll
-from claudechic.widgets.chat_view import ChatView
-from claudechic.widgets.collapsible import QuietCollapsible
-from claudechic.widgets.history_search import HistorySearch
-from claudechic.widgets.usage import UsageReport
-from claudechic.widgets.profile_modal import ProfileModal
 
 __all__ = [
-    "Button",
+    # Base
     "ClickableMixin",
-    "CPUBar",
-    "ContextBar",
+    "PointerMixin",
+    "CopyButton",
+    "CopyableMixin",
+    "ToolWidget",
+    # Primitives
+    "Button",
+    "QuietCollapsible",
+    "AutoHideScroll",
+    "Spinner",
+    # Content
     "ChatMessage",
     "ChatInput",
-    "ChatAttachment",
-    "Spinner",
     "ThinkingIndicator",
     "ImageAttachments",
     "ErrorMessage",
     "SystemInfo",
+    "ChatAttachment",
     "ToolUseWidget",
     "TaskWidget",
     "AgentToolWidget",
@@ -67,21 +117,42 @@ __all__ = [
     "DiffWidget",
     "TodoWidget",
     "TodoPanel",
-    "BasePrompt",
-    "SelectionPrompt",
-    "QuestionPrompt",
-    "SessionItem",
+    # Input
     "TextAreaAutoComplete",
+    "HistorySearch",
+    # Layout
+    "ChatView",
     "AgentItem",
-    "AgentSidebar",
+    "AgentSection",
     "WorktreeItem",
-    "PlanButton",
+    "SessionItem",
+    "PlanItem",
+    "PlanSection",
+    "SidebarSection",
+    "SidebarItem",
     "HamburgerButton",
-    "AutoHideScroll",
-    "ChatView",
-    "QuietCollapsible",
-    "HistorySearch",
+    "ClickableLabel",
+    "AutoEditLabel",
+    "ModelLabel",
+    "StatusFooter",
+    "IndicatorWidget",
+    "CPUBar",
+    "ContextBar",
+    "ProcessIndicator",
+    "ProcessPanel",
+    "ProcessItem",
+    "BackgroundProcess",
+    # Reports
     "UsageReport",
+    "ContextReport",
+    # Modals
     "ProfileModal",
+    "ProcessModal",
+    # Prompts
+    "BasePrompt",
+    "SelectionPrompt",
+    "QuestionPrompt",
     "ModelPrompt",
+    "WorktreePrompt",
+    "UncommittedChangesPrompt",
 ]

claudechic/widgets/base/__init__.py

@@ -0,0 +1,20 @@
+"""Base classes and mixins for widgets."""
+
+from claudechic.widgets.base.cursor import (
+    ClickableMixin,
+    PointerMixin,
+    set_pointer,
+)
+from claudechic.widgets.base.copyable import CopyButton, CopyableMixin
+from claudechic.widgets.base.clickable import ClickableLabel
+from claudechic.widgets.base.tool_protocol import ToolWidget
+
+__all__ = [
+    "ClickableMixin",
+    "PointerMixin",
+    "set_pointer",
+    "CopyButton",
+    "CopyableMixin",
+    "ClickableLabel",
+    "ToolWidget",
+]

claudechic/widgets/base/clickable.py

@@ -0,0 +1,23 @@
+"""Clickable label widget - static text with pointer cursor."""
+
+from textual.widgets import Static
+
+from claudechic.widgets.base.cursor import ClickableMixin
+
+
+class ClickableLabel(Static, ClickableMixin):
+    """A static label that is clickable with pointer cursor.
+
+    Base class for labels that respond to clicks. Override on_click()
+    to handle clicks, or post custom messages.
+
+    Example:
+        class MyLabel(ClickableLabel):
+            class Clicked(Message):
+                pass
+
+            def on_click(self, event) -> None:
+                self.post_message(self.Clicked())
+    """
+
+    pass

claudechic/widgets/base/copyable.py

@@ -0,0 +1,55 @@
+"""Copyable mixin for widgets with copy-to-clipboard functionality."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from claudechic.widgets.primitives.button import Button
+
+if TYPE_CHECKING:
+    from textual.app import App
+
+
+class CopyButton(Button):
+    """Copy button with hand cursor on hover."""
+
+    pass
+
+
+class CopyableMixin:
+    """Mixin for widgets that support copying content to clipboard.
+
+    Usage:
+        class MyWidget(Static, CopyableMixin):
+            def compose(self):
+                yield CopyButton("⧉", classes="copy-btn")
+                ...
+
+            def get_copyable_content(self) -> str:
+                return "content to copy"
+
+            def on_button_pressed(self, event):
+                if self.handle_copy_button(event):
+                    return
+    """
+
+    def get_copyable_content(self) -> str:
+        """Return content to copy. Override in subclass."""
+        raise NotImplementedError("Subclass must implement get_copyable_content()")
+
+    # Type hint for app - mixin expects to be used with Widget
+    app: App
+
+    def handle_copy_button(self, event: Button.Pressed) -> bool:
+        """Handle copy button press. Returns True if handled."""
+        if "copy-btn" in event.button.classes:
+            event.stop()
+            try:
+                import pyperclip
+
+                pyperclip.copy(self.get_copyable_content())
+                self.app.notify("Copied to clipboard")
+            except Exception as e:
+                self.app.notify(f"Copy failed: {e}", severity="error")
+            return True
+        return False

claudechic/{cursor.py → widgets/base/cursor.py}

@@ -1,12 +1,14 @@
-"""Mouse cursor and hover mixins for Textual widgets.
+"""Mouse cursor mixins for Textual widgets.
 
-Provides three mixins for different use cases:
-- ClickableMixin: Hand cursor + .hovered class (for buttons)
+Provides two mixins:
+- ClickableMixin: Hand cursor on hover (for buttons)
 - PointerMixin: Configurable cursor style (for text areas)
-- HoverableMixin: Just .hovered class (for hover effects without cursor)
 
 Uses OSC 22 escape sequences supported by modern terminals
 (Ghostty, Kitty, WezTerm, foot). Unsupported terminals ignore the sequence.
+
+Note: For hover visual effects, use CSS :hover pseudo-class instead of
+adding/removing classes - much more efficient (no DOM style recalc).
 """
 
 import os
@@ -72,28 +74,11 @@ class PointerMixin:
             super().on_leave()  # type: ignore[misc]
 
 
-class HoverableMixin:
-    """Mixin for widgets that need a .hovered class for CSS styling.
-
-    Adds/removes 'hovered' class on mouse enter/leave. Useful when
-    CSS :hover doesn't propagate properly through child widgets.
-    """
-
-    def on_enter(self) -> None:
-        if not self.has_class("hovered"):  # type: ignore[attr-defined]
-            self.add_class("hovered")  # type: ignore[attr-defined]
-
-    def on_leave(self) -> None:
-        if self.has_class("hovered"):  # type: ignore[attr-defined]
-            self.remove_class("hovered")  # type: ignore[attr-defined]
-        set_pointer("default")
-
-
 class ClickableMixin:
-    """Mixin for clickable widgets with hand cursor and hover state.
+    """Mixin for clickable widgets with hand cursor.
 
-    Combines pointer cursor with .hovered class. Use for buttons and
-    clickable containers.
+    Shows pointer cursor on hover. Use CSS :hover for visual styling
+    instead of .hovered class (much more efficient).
 
     Example:
         class MyButton(Static, ClickableMixin):
@@ -106,10 +91,6 @@ class ClickableMixin:
 
     def on_enter(self) -> None:
         set_pointer("pointer")
-        if not self.has_class("hovered"):  # type: ignore[attr-defined]
-            self.add_class("hovered")  # type: ignore[attr-defined]
 
     def on_leave(self) -> None:
         set_pointer("default")
-        if self.has_class("hovered"):  # type: ignore[attr-defined]
-            self.remove_class("hovered")  # type: ignore[attr-defined]

claudechic/widgets/base/tool_protocol.py

@@ -0,0 +1,30 @@
+"""Protocol for tool display widgets."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol, runtime_checkable
+
+if TYPE_CHECKING:
+    from claude_agent_sdk import ToolResultBlock
+
+
+@runtime_checkable
+class ToolWidget(Protocol):
+    """Protocol for widgets that display tool use/results.
+
+    Implemented by:
+    - ToolUseWidget: Standard tool display with collapsible details
+    - TaskWidget: Nested subagent display
+    - AgentToolWidget: MCP chic agent tools (spawn_agent, ask_agent, etc.)
+
+    This protocol enables ChatView to treat all tool widgets uniformly
+    for operations like collapse() and set_result().
+    """
+
+    def collapse(self) -> None:
+        """Collapse this widget to save visual space."""
+        ...
+
+    def set_result(self, result: "ToolResultBlock") -> None:
+        """Update the widget with the tool's result."""
+        ...

claudechic/widgets/content/__init__.py

@@ -0,0 +1,41 @@
+"""Content display widgets - messages, tools, diffs."""
+
+from claudechic.widgets.content.message import (
+    ChatMessage,
+    ChatInput,
+    ThinkingIndicator,
+    ImageAttachments,
+    ErrorMessage,
+    SystemInfo,
+    ChatAttachment,
+)
+from claudechic.widgets.content.tools import (
+    ToolUseWidget,
+    TaskWidget,
+    AgentToolWidget,
+    AgentListWidget,
+    ShellOutputWidget,
+    EditPlanRequested,
+)
+from claudechic.widgets.content.diff import DiffWidget
+from claudechic.widgets.content.todo import TodoWidget, TodoPanel, TodoItem
+
+__all__ = [
+    "ChatMessage",
+    "ChatInput",
+    "ThinkingIndicator",
+    "ImageAttachments",
+    "ErrorMessage",
+    "SystemInfo",
+    "ChatAttachment",
+    "ToolUseWidget",
+    "TaskWidget",
+    "AgentToolWidget",
+    "AgentListWidget",
+    "ShellOutputWidget",
+    "EditPlanRequested",
+    "DiffWidget",
+    "TodoWidget",
+    "TodoPanel",
+    "TodoItem",
+]

claudechic/widgets/{diff.py → content/diff.py}

@@ -5,7 +5,6 @@ import re
 from functools import lru_cache
 
 from pygments.lexers import get_lexer_by_name
-from pygments.token import Token
 from pygments.util import ClassNotFound
 from textual.content import Content, Span
 from textual.containers import HorizontalScroll
@@ -15,74 +14,25 @@ from textual.widgets import Static
 from claudechic.formatting import get_lang_from_path
 
 
+# Colors - line backgrounds
+REMOVED_BG = "#301010"
+ADDED_BG = "#103010"
+# Word-level change highlights
+REMOVED_WORD_STYLE = "underline on #501818"
+ADDED_WORD_STYLE = "underline on #185018"
+
+
 @lru_cache(maxsize=64)
 def _get_cached_lexer(language: str):
-    """Get a cached Pygments lexer by language name.
-
-    Caching lexers avoids the expensive lexer loading/guessing on every highlight call.
-    The profiler showed ~15% of CPU time was spent in _load_lexers and guess_lexer.
-    """
+    """Cache Pygments lexers to avoid repeated loading (~15% CPU savings)."""
     try:
         return get_lexer_by_name(language, stripnl=False, ensurenl=True, tabsize=8)
     except ClassNotFound:
         return None
 
 
-# Colors - line backgrounds (subtle tint)
-REMOVED_BG = "#200000"
-ADDED_BG = "#002000"
-# Word-level change highlights - subtle background + underline
-REMOVED_WORD_STYLE = "underline on #330808"
-ADDED_WORD_STYLE = "underline on #083308"
-
-
-class DiffHighlightTheme(HighlightTheme):
-    """Syntax highlighting theme for diffs, aligned with chic theme.
-
-    Uses orange as primary accent, saturated blues for structure,
-    and avoids red/green that clash with diff backgrounds.
-    """
-
-    STYLES = {
-        Token.Comment: "#888888",  # Brighter gray for visibility
-        Token.Error: "#ff6b6b",  # Soft red for errors
-        Token.Generic.Strong: "bold",
-        Token.Generic.Emph: "italic",
-        Token.Generic.Error: "#ff6b6b",
-        Token.Generic.Heading: "#ff9922 underline",  # Bright orange
-        Token.Generic.Subheading: "#ff9922",
-        Token.Keyword: "#ff9922",  # Bright orange for keywords
-        Token.Keyword.Constant: "#66bbff bold",  # Vivid blue
-        Token.Keyword.Namespace: "#ff9922",  # Bright orange
-        Token.Keyword.Type: "#66bbff bold",  # Vivid blue
-        Token.Literal.Number: "#ffcc66",  # Bright gold
-        Token.Literal.String.Backtick: "#888888",  # Gray
-        Token.Literal.String: "#77ccff",  # Bright cyan-blue
-        Token.Literal.String.Doc: "#77ccff italic",
-        Token.Literal.String.Double: "#77ccff",
-        Token.Name: "#dddddd",  # Bright base text
-        Token.Name.Attribute: "#ffcc66",  # Bright gold
-        Token.Name.Builtin: "#66bbff",  # Vivid blue
-        Token.Name.Builtin.Pseudo: "#66bbff italic",
-        Token.Name.Class: "#ff9922 bold",  # Bright orange
-        Token.Name.Constant: "#66bbff",  # Vivid blue
-        Token.Name.Decorator: "#ff9922 bold",  # Bright orange
-        Token.Name.Function: "#ffcc66",  # Bright gold
-        Token.Name.Function.Magic: "#ffcc66",
-        Token.Name.Tag: "#ff9922 bold",  # Bright orange
-        Token.Name.Variable: "#88ddff",  # Light cyan
-        Token.Operator: "#dddddd bold",  # Bright base
-        Token.Operator.Word: "#ff9922 bold",  # Bright orange
-        Token.Whitespace: "",
-    }
-
-
 def _highlight_text(text: str, language: str) -> Content:
-    """Syntax highlight text using cached lexer and DiffHighlightTheme.
-
-    Performance-optimized version of textual.highlight.highlight() that
-    reuses cached lexer instances instead of creating new ones each time.
-    """
+    """Syntax highlight text using cached lexer and default HighlightTheme."""
     if not language:
         return Content(text)
 
@@ -90,19 +40,15 @@ def _highlight_text(text: str, language: str) -> Content:
     if lexer is None:
         return Content(text)
 
-    # Normalize line endings
     text = "\n".join(text.splitlines())
-
-    # Build spans from Pygments tokens
     token_start = 0
     spans: list[Span] = []
 
     for token_type, token in lexer.get_tokens(text):
         token_end = token_start + len(token)
-        # Walk up parent chain to find matching style
         current_type = token_type
         while True:
-            if style := DiffHighlightTheme.STYLES.get(current_type):
+            if style := HighlightTheme.STYLES.get(current_type):
                 spans.append(Span(token_start, token_end, style))
                 break
             if (current_type := current_type.parent) is None: