gitux 0.1.0__py3-none-any.whl

gitux/ui/gitux.tcss

@@ -0,0 +1,323 @@
+Screen {
+    background: #13131b;
+}
+
+* {
+    color: #e4e1ed;
+}
+
+#top-bar {
+    dock: top;
+    height: 1;
+    background: #1f1f27;
+    color: #e4e1ed;
+    padding: 0 1;
+    text-style: bold;
+}
+
+#stats-bar {
+    dock: top;
+    height: 1;
+    background: #1f1f27;
+    color: #c7c4d7;
+    padding: 0 1;
+}
+
+#main-content {
+    height: 1fr;
+    layout: vertical;
+}
+
+#bento-top {
+    height: 1fr;
+    layout: horizontal;
+}
+
+#files-block {
+    width: 1fr;
+    min-width: 30;
+}
+
+#commits-block {
+    height: 1fr;
+}
+
+#commit-log {
+    height: 1fr;
+    overflow-y: auto;
+    overflow-x: hidden;
+    padding: 0 1;
+    color: #e4e1ed;
+    background: transparent;
+    scrollbar-visibility: hidden;
+}
+
+.block-active {
+    border: solid #c0c1ff;
+    background: #0d0d15;
+}
+
+.block-inactive {
+    border: solid #464554;
+    background: #0d0d15;
+}
+
+.block-header {
+    height: 1;
+    background: #34343d;
+    padding: 0 1;
+    text-style: bold;
+}
+
+.block-active .block-header {
+    color: #e4e1ed;
+}
+
+.block-inactive .block-header {
+    color: #c7c4d7;
+}
+
+#changed-files {
+    height: 1fr;
+    overflow-y: auto;
+    overflow-x: hidden;
+    padding: 0 1;
+    background: transparent;
+    scrollbar-visibility: hidden;
+}
+
+.staged-section {
+    color: #c0c1ff;
+}
+
+.unstaged-section {
+    color: #ffb783;
+}
+
+.file-status-M { color: #ffb783; }
+.file-status-A { color: #10b981; }
+.file-status-D { color: #ffb4ab; }
+.file-status-R { color: #c0c1ff; }
+.file-status-C { color: #c0c1ff; }
+.file-status-unknown { color: #908fa0; }
+
+#diff-viewer {
+    height: 1fr;
+    overflow-y: auto;
+    padding: 0 1;
+    background: transparent;
+    scrollbar-visibility: hidden;
+}
+
+GituxFooter {
+    dock: bottom;
+    height: 1;
+    background: #1f1f27;
+    color: #c7c4d7;
+    padding: 0 1;
+}
+
+#commit-modal {
+    background: #34343d;
+    border: solid #c0c1ff;
+    color: #e4e1ed;
+    width: 60%;
+    height: 13;
+}
+
+#help-container {
+    background: #34343d;
+    border: solid #c0c1ff;
+    color: #e4e1ed;
+    width: 64;
+    max-width: 90%;
+    max-height: 85%;
+    padding: 1 2;
+    overflow-y: auto;
+}
+
+#help-title {
+    text-style: bold;
+    color: #c0c1ff;
+    text-align: center;
+    margin: 0 0 1 0;
+    content-align: center middle;
+    height: 1;
+}
+
+#help-body {
+    color: #e4e1ed;
+}
+
+#help-body .key {
+    color: #ffb783;
+    text-style: bold;
+}
+
+#help-close-hint {
+    text-style: italic;
+    color: #c7c4d7;
+    text-align: center;
+    margin: 1 0 0 0;
+    height: 1;
+}
+
+CommitScreen {
+    background: #13131b 85%;
+    align: center middle;
+    height: 13;
+}
+
+#commit-modal-type {
+    height: 1;
+    text-align: center;
+    color: #ffb783;
+    margin: 0 0 1 0;
+}
+
+#commit-modal-title {
+    text-style: bold;
+    color: #c0c1ff;
+    margin: 0 0 1 0;
+    height: 1;
+    text-align: center;
+}
+
+#commit-modal-input {
+    width: 100%;
+    height: 3;
+    background: #1f1f27;
+    color: #e4e1ed;
+    border: solid #464554;
+    padding: 0 1;
+    margin: 0 0 1 0;
+}
+
+#commit-modal-input:focus {
+    border: solid #c0c1ff;
+}
+
+#commit-modal-input .input--cursor {
+    color: #13131b;
+    background: #c0c1ff;
+}
+
+#commit-modal-buttons {
+    layout: horizontal;
+    height: 3;
+    align: center middle;
+}
+
+#commit-modal-btn-commit {
+    width: 16;
+    min-width: 16;
+    max-width: 16;
+    margin: 0 1 0 0;
+    background: #10b981;
+    color: #0d0d15;
+    text-style: bold;
+    border: none;
+}
+
+#commit-modal-btn-commit:hover {
+    background: #34d399;
+}
+
+#commit-modal-btn-commit:disabled {
+    background: #1f1f27;
+    color: #c7c4d7;
+}
+
+#commit-modal-btn-cancel {
+    width: 16;
+    min-width: 16;
+    max-width: 16;
+    background: transparent;
+    color: #908fa0;
+    text-style: bold;
+    border: none;
+}
+
+#commit-modal-btn-cancel:hover {
+    background: #1f1f27;
+    color: #e4e1ed;
+}
+
+HelpScreen {
+    background: #13131b 80%;
+    align: center middle;
+}
+
+BranchScreen {
+    background: #13131b 85%;
+    align: center middle;
+}
+
+#branch-modal {
+    background: #34343d;
+    border: solid #c0c1ff;
+    color: #e4e1ed;
+    width: 50;
+    max-width: 90%;
+    height: auto;
+    padding: 1 2;
+}
+
+#branch-modal-title {
+    text-style: bold;
+    color: #c0c1ff;
+    text-align: center;
+    height: 1;
+    margin: 0 0 1 0;
+}
+
+#branch-option-list {
+    background: #1f1f27;
+    color: #e4e1ed;
+    border: solid #464554;
+    height: auto;
+    max-height: 60%;
+}
+
+#branch-option-list > .option-list--option-highlighted {
+    background: #3a4a5f;
+    color: #e4e1ed;
+}
+
+#branch-modal-hint {
+    text-style: italic;
+    color: #c7c4d7;
+    text-align: center;
+    height: 1;
+    margin: 1 0 0 0;
+}
+
+Toast {
+    background: #1f1f27;
+    border: solid #464554;
+    padding: 0 1;
+}
+
+Toast.-information {
+    border: solid #10b981;
+}
+
+Toast.-information .toast-title {
+    color: #10b981;
+}
+
+Toast.-error {
+    border: solid #ffb4ab;
+}
+
+Toast.-error .toast-title {
+    color: #ffb4ab;
+}
+
+Toast.-warning {
+    border: solid #ffb783;
+}
+
+Toast.-warning .toast-title {
+    color: #ffb783;
+}

gitux/ui/widgets/__init__.py

@@ -0,0 +1,24 @@
+from gitux.ui.widgets.block_container import BlockContainer
+from gitux.ui.widgets.branch_screen import BranchScreen
+from gitux.ui.widgets.changed_files import ChangedFilesPanel
+from gitux.ui.widgets.commit_log import CommitLogWidget, extract_commit_hash
+from gitux.ui.widgets.commit_screen import CommitScreen
+from gitux.ui.widgets.diff_viewer import DiffViewerWidget
+from gitux.ui.widgets.gitux_footer import GituxFooter
+from gitux.ui.widgets.header import TopAppBar
+from gitux.ui.widgets.help_screen import HelpScreen
+from gitux.ui.widgets.repo_stats_bar import RepoStatsBar
+
+__all__ = [
+    "BlockContainer",
+    "BranchScreen",
+    "ChangedFilesPanel",
+    "CommitLogWidget",
+    "CommitScreen",
+    "DiffViewerWidget",
+    "GituxFooter",
+    "HelpScreen",
+    "RepoStatsBar",
+    "TopAppBar",
+    "extract_commit_hash",
+]

gitux/ui/widgets/block_container.py

@@ -0,0 +1,61 @@
+"""Block container — wraps a content widget with a styled header and active state."""
+
+from typing import override
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.widget import Widget
+from textual.widgets import Static
+
+
+class BlockContainer(Vertical):
+    """Bento-grid block that wraps a content widget with a styled title header.
+
+    Supports active/inactive visual states via CSS classes (``.block-active`` /
+    ``.block-inactive``) for keyboard focus indication.
+
+    Used to wrap ChangedFilesPanel, CommitLogWidget, and DiffViewerWidget in the
+    bento layout.
+    """
+
+    def __init__(
+        self,
+        title: str,
+        subtitle: str = "",
+        content_widget: Widget | None = None,
+        name: str | None = None,
+        id: str | None = None,
+        classes: str | None = None,
+        disabled: bool = False,
+    ) -> None:
+        super().__init__(name=name, id=id, classes=classes, disabled=disabled)
+        self._title: str = title
+        self._subtitle: str = subtitle
+        self._content_widget: Widget | None = content_widget
+        self._active: bool = False
+        _ = self.set_class(True, "block-inactive")
+
+    @override
+    def compose(self) -> ComposeResult:
+        """Yield the header static and the wrapped content widget."""
+        yield Static(self._render_header(), classes="block-header")
+        if self._content_widget:
+            yield self._content_widget
+
+    def set_active(self, active: bool) -> None:
+        """Toggle the active state, which changes the border styling."""
+        self._active = active
+        _ = self.set_class(active, "block-active")
+        _ = self.set_class(not active, "block-inactive")
+
+    def set_header_subtitle(self, subtitle: str) -> None:
+        """Update the subtitle text in the block header in-place."""
+        self._subtitle = subtitle
+        header = self.query_one(".block-header", Static)
+        header.update(self._render_header())
+
+    def _render_header(self) -> str:
+        """Render the header line: ``Title / subtitle`` or just the title."""
+        if self._subtitle:
+            return f"{self._title} / {self._subtitle}"
+        return self._title

gitux/ui/widgets/branch_screen.py

@@ -0,0 +1,54 @@
+"""Branch switch modal — lists local branches and switches on selection."""
+
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import OptionList, Static
+
+from gitux.git import GitError
+from gitux.presenter.repo_presenter import RepoPresenter
+from typing import override
+
+
+class BranchScreen(ModalScreen[str]):
+    """Modal listing local branches; Enter switches, Escape cancels."""
+
+    BINDINGS: list[Binding] = [Binding("escape", "cancel", "Cancel")]
+
+    def __init__(self, presenter: RepoPresenter) -> None:
+        super().__init__()
+        self.presenter: RepoPresenter = presenter
+
+    @override
+    def compose(self) -> ComposeResult:
+        """Build the modal: title, branch list, and hint line."""
+        with Vertical(id="branch-modal"):
+            yield Static("Switch Branch", id="branch-modal-title")
+            yield OptionList(id="branch-option-list")
+            yield Static("Enter: switch \u2022 Esc: cancel", id="branch-modal-hint")
+
+    def on_mount(self) -> None:
+        """Populate the branch list and focus it."""
+        option_list = self.query_one("#branch-option-list", OptionList)
+        branches = self.presenter.get_branches()
+        for name in branches:
+            _ = option_list.add_option(name)
+        if not branches:
+            _ = self.query_one("#branch-modal-hint", Static).update("No branches found")
+        else:
+            _ = option_list.focus()
+
+    def on_option_list_option_selected(self, event: OptionList.OptionSelected) -> None:
+        """Switch to the selected branch and dismiss, or notify on error."""
+        branch = str(event.option.prompt)
+        try:
+            self.presenter.switch_branch(branch)
+        except GitError as exc:
+            _ = self.notify(str(exc), severity="error")
+            return
+        _ = self.dismiss(branch)
+
+    def action_cancel(self) -> None:
+        """Dismiss the modal without selecting a branch."""
+        _ = self.dismiss(None)

gitux/ui/widgets/changed_files.py

@@ -0,0 +1,187 @@
+"""Changed files panel — staged/unstaged file list with cursor navigation."""
+
+from collections.abc import Callable
+
+from rich.text import Text
+from textual.widgets import RichLog
+
+from gitux.domain import FileStatus
+
+
+_STATUS_COLORS: dict[str, str] = {
+    "M": "#ffb783",
+    "A": "#10b981",
+    "D": "#ffb4ab",
+    "R": "#c0c1ff",
+    "C": "#c0c1ff",
+    "?": "#908fa0",
+    "!": "#c7c4d7",
+}
+
+_MAX_PATH_CHARS: int = 40
+
+
+class ChangedFilesPanel(RichLog):
+    """File listing panel with staged and unstaged sections."""
+
+    can_focus = False
+
+    def __init__(self, **kwargs) -> None:
+        super().__init__(
+            highlight=False, markup=False, auto_scroll=False, max_lines=None, **kwargs
+        )
+        self._files: list[FileStatus] = []
+        self._cursor_index: int = 0
+        self._on_toggle: Callable[[FileStatus], None] | None = None
+        self._on_selection_change: Callable[[], None] | None = None
+        self._on_stage_all: Callable[[], None] | None = None
+        self._on_unstage_all: Callable[[], None] | None = None
+
+    @property
+    def selected_file(self) -> FileStatus | None:
+        """Return the :class:`FileStatus` under the cursor, or ``None``."""
+        all_files = self._all_files_flat
+        if 0 <= self._cursor_index < len(all_files):
+            return all_files[self._cursor_index]
+        return None
+
+    @property
+    def _all_files_flat(self) -> list[FileStatus]:
+        """Staged files followed by unstaged files, in cursor order."""
+        staged = [f for f in self._files if f.is_staged]
+        unstaged = [f for f in self._files if f.is_unstaged]
+        return staged + unstaged
+
+    def set_files(self, files: list[FileStatus]) -> None:
+        """Replace the file list and reset cursor if out of bounds."""
+        self._files = files
+        total = len(self._all_files_flat)
+        if self._cursor_index >= total:
+            self._cursor_index = max(0, total - 1)
+        self._refresh_content()
+        self._scroll_to_cursor()
+
+    def set_on_toggle(self, callback: Callable[[FileStatus], None]) -> None:
+        """Register a callback invoked when the user toggles a file's staged state."""
+        self._on_toggle = callback
+
+    def set_on_selection_change(self, callback: Callable[[], None]) -> None:
+        """Register a callback invoked when the cursor moves to a different file."""
+        self._on_selection_change = callback
+
+    def set_on_stage_all(self, callback: Callable[[], None]) -> None:
+        """Register a callback invoked when the user triggers stage-all."""
+        self._on_stage_all = callback
+
+    def set_on_unstage_all(self, callback: Callable[[], None]) -> None:
+        """Register a callback invoked when the user triggers unstage-all."""
+        self._on_unstage_all = callback
+
+    def action_cursor_down(self) -> None:
+        """Move cursor down to the next file in the flat list."""
+        all_files = self._all_files_flat
+        if self._cursor_index < len(all_files) - 1:
+            self._cursor_index += 1
+            self._refresh_content()
+            self._scroll_to_cursor()
+            if self._on_selection_change:
+                self._on_selection_change()
+
+    def action_cursor_up(self) -> None:
+        """Move cursor up to the previous file in the flat list."""
+        if self._cursor_index > 0:
+            self._cursor_index -= 1
+            self._refresh_content()
+            self._scroll_to_cursor()
+            if self._on_selection_change:
+                self._on_selection_change()
+
+    def action_toggle_file(self) -> None:
+        """Stage or unstage the file under the cursor."""
+        file = self.selected_file
+        if file and self._on_toggle:
+            self._on_toggle(file)
+
+    def action_stage_all(self) -> None:
+        """Stage all currently unstaged files."""
+        if self._on_stage_all:
+            self._on_stage_all()
+
+    def action_unstage_all(self) -> None:
+        """Unstage all currently staged files."""
+        if self._on_unstage_all:
+            self._on_unstage_all()
+
+    def _refresh_content(self) -> None:
+        """Clear the widget and re-render the full file list."""
+        _ = self.clear()
+        _ = self.write(self._render_files())
+
+    def _render_files(self) -> Text:
+        """Build the full layout with STAGED and UNSTAGED sections."""
+        text = Text(no_wrap=True)
+        staged = [f for f in self._files if f.is_staged]
+        unstaged = [f for f in self._files if f.is_unstaged]
+
+        text.append(" \u25a0 STAGED", style="bold #c0c1ff")
+        text.append("\n")
+
+        if staged:
+            text.append(self._build_file_entries(staged, 0))
+        else:
+            text.append("   No changed files\n", style="italic #c7c4d7")
+
+        text.append(" \u25a0 UNSTAGED", style="bold #ffb783")
+        text.append("\n")
+
+        if unstaged:
+            text.append(self._build_file_entries(unstaged, len(staged)))
+        else:
+            text.append("   No changed files\n", style="italic #c7c4d7")
+
+        return text
+
+    def _build_file_entries(self, files: list[FileStatus], start_index: int) -> Text:
+        """Build rich text entries for a slice of files, marking the cursor row."""
+        text = Text()
+        for i, f in enumerate(files):
+            linear_idx = start_index + i
+            is_cursor = linear_idx == self._cursor_index
+            status = f.display_status
+            color = _STATUS_COLORS.get(status, "#e4e1ed")
+
+            if is_cursor:
+                text.append(" \u276f", style="bold #c0c1ff")
+            else:
+                text.append("  ")
+
+            text.append(f" {status}", style=f"bold {color}")
+            text.append(f" {self._truncate_path(f.display_path)}", style="#e4e1ed")
+            text.append("\n")
+
+        return text
+
+    def _truncate_path(self, display_path: str) -> str:
+        """Truncate a rendered path to ``_MAX_PATH_CHARS`` with a trailing ``..``."""
+        if len(display_path) > _MAX_PATH_CHARS:
+            return display_path[:_MAX_PATH_CHARS - 2] + ".."
+        return display_path
+
+    def _row_for_index(self, index: int) -> int:
+        """Rendered-line offset of flat cursor ``index`` (accounts for section headers)."""
+        all_files = self._all_files_flat
+        if not all_files:
+            return 0
+        staged_count = len([f for f in self._files if f.is_staged])
+        if index < staged_count:
+            return 1 + index
+        if staged_count > 0:
+            return index + 2
+        return index + 3
+
+    def _scroll_to_cursor(self) -> None:
+        """Ensure the cursor row is visible; no-op when the file list is empty."""
+        if not self._all_files_flat:
+            return
+        target = 0 if self._cursor_index == 0 else self._row_for_index(self._cursor_index)
+        self.scroll_to(y=target, animate=False)