zettcode-tui 0.4.0__py3-none-any.whl

zettcode/tui/themes/kanagawa.toml

@@ -0,0 +1,44 @@
+description = "ink blue and faded gold"
+base = "dark"
+
+[ui]
+background = "#1f1f28"
+surface = "#252535"
+surface_alt = "#2a2a37"
+surface_side = "#323547"
+surface_peer = "#383548"
+text = "#dcd7ba"
+muted = "#8b8a83"
+subtle = "#c8c093"
+accent = "#7e9cd8"
+accent_bright = "#7fb4ca"
+warning = "#e6c384"
+error = "#e46876"
+border = "#363646"
+focus = "#7fb4ca"
+selection = "#2d4f67"
+diff_added = "#98bb6c"
+diff_removed = "#e46876"
+
+[tools]
+read = "#e6c384"
+search = "#7e9cd8"
+image = "#7e9cd8"
+write = "#ffa066"
+delete = "#e46876"
+shell = "#7e9cd8"
+plan = "#7e9cd8"
+subagent = "#7aa89f"
+message = "#d27e99"
+
+[code]
+inline = "#98bb6c"
+text = "#dcd7ba"
+keyword = "#957fb8"
+string = "#98bb6c"
+comment = "#8b8a83"
+number = "#ffa066"
+function = "#7e9cd8"
+builtin = "#957fb8"
+operator = "#c8c093"
+punctuator = "#c8c093"

zettcode/tui/themes/nord.toml

@@ -0,0 +1,44 @@
+description = "arctic blue-grey, very low saturation"
+base = "dark"
+
+[ui]
+background = "#2e3440"
+surface = "#343b49"
+surface_alt = "#3b4252"
+surface_side = "#424c5d"
+surface_peer = "#4b4c5e"
+text = "#eceff4"
+muted = "#9ca6b8"
+subtle = "#d8dee9"
+accent = "#88c0d0"
+accent_bright = "#8fbcbb"
+warning = "#ebcb8b"
+error = "#ca7d84"
+border = "#4c566a"
+focus = "#8fbcbb"
+selection = "#434c5e"
+diff_added = "#a3be8c"
+diff_removed = "#ca7d84"
+
+[tools]
+read = "#ebcb8b"
+search = "#81a1c1"
+image = "#81a1c1"
+write = "#d08770"
+delete = "#ca7d84"
+shell = "#81a1c1"
+plan = "#81a1c1"
+subagent = "#8fbcbb"
+message = "#b48ead"
+
+[code]
+inline = "#a3be8c"
+text = "#eceff4"
+keyword = "#81a1c1"
+string = "#a3be8c"
+comment = "#9ca6b8"
+number = "#d08770"
+function = "#81a1c1"
+builtin = "#b48ead"
+operator = "#d8dee9"
+punctuator = "#d8dee9"

zettcode/tui/themes/one-dark.toml

@@ -0,0 +1,44 @@
+description = "Atom's neutral blue-grey classic"
+base = "dark"
+
+[ui]
+background = "#282c34"
+surface = "#2c313a"
+surface_alt = "#333842"
+surface_side = "#384453"
+surface_peer = "#464056"
+text = "#c4c9d2"
+muted = "#959aa2"
+subtle = "#acb2bf"
+accent = "#61afef"
+accent_bright = "#56b6c2"
+warning = "#e5c07b"
+error = "#e06c75"
+border = "#3e4451"
+focus = "#56b6c2"
+selection = "#3e4451"
+diff_added = "#98c379"
+diff_removed = "#e06c75"
+
+[tools]
+read = "#e5c07b"
+search = "#61afef"
+image = "#61afef"
+write = "#d19a66"
+delete = "#e06c75"
+shell = "#61afef"
+plan = "#61afef"
+subagent = "#56b6c2"
+message = "#c678dd"
+
+[code]
+inline = "#98c379"
+text = "#c4c9d2"
+keyword = "#c678dd"
+string = "#98c379"
+comment = "#959aa2"
+number = "#d19a66"
+function = "#61afef"
+builtin = "#c678dd"
+operator = "#acb2bf"
+punctuator = "#acb2bf"

zettcode/tui/themes/rose-pine-dawn.toml

@@ -0,0 +1,44 @@
+description = "warm paper with violet and rose"
+base = "light"
+
+[ui]
+background = "#faf4ed"
+surface = "#fffaf3"
+surface_alt = "#f2e9e1"
+surface_side = "#dedcd8"
+surface_peer = "#e5dbda"
+text = "#4c486a"
+muted = "#726e7c"
+subtle = "#5b586e"
+accent = "#826e98"
+accent_bright = "#a76562"
+warning = "#9e6a23"
+error = "#ab5e74"
+border = "#dfdad9"
+focus = "#a76562"
+selection = "#dfdad9"
+diff_added = "#497e87"
+diff_removed = "#ab5e74"
+
+[tools]
+read = "#9a6e3c"
+search = "#497e87"
+image = "#497e87"
+write = "#9e6a23"
+delete = "#ab5e74"
+shell = "#497e87"
+plan = "#497e87"
+subagent = "#497e87"
+message = "#ab5e74"
+
+[code]
+inline = "#497e87"
+text = "#4c486a"
+keyword = "#286983"
+string = "#497e87"
+comment = "#726e7c"
+number = "#a76562"
+function = "#286983"
+builtin = "#826e98"
+operator = "#5b586e"
+punctuator = "#5b586e"

zettcode/tui/themes/rose-pine.toml

@@ -0,0 +1,44 @@
+description = "dark violet with rose gold"
+base = "dark"
+
+[ui]
+background = "#191724"
+surface = "#1f1d2e"
+surface_alt = "#26233a"
+surface_side = "#272b42"
+surface_peer = "#3b3450"
+text = "#e0def4"
+muted = "#87849b"
+subtle = "#9e9ab5"
+accent = "#c4a7e7"
+accent_bright = "#ebbcba"
+warning = "#f6c177"
+error = "#eb6f92"
+border = "#403d52"
+focus = "#ebbcba"
+selection = "#403d52"
+diff_added = "#9ccfd8"
+diff_removed = "#eb6f92"
+
+[tools]
+read = "#f6c177"
+search = "#9ccfd8"
+image = "#9ccfd8"
+write = "#ebbcba"
+delete = "#eb6f92"
+shell = "#9ccfd8"
+plan = "#9ccfd8"
+subagent = "#9ccfd8"
+message = "#eb6f92"
+
+[code]
+inline = "#9ccfd8"
+text = "#e0def4"
+keyword = "#46829a"
+string = "#9ccfd8"
+comment = "#87849b"
+number = "#ebbcba"
+function = "#46829a"
+builtin = "#c4a7e7"
+operator = "#9e9ab5"
+punctuator = "#9e9ab5"

zettcode/tui/themes/solarized-dark.toml

@@ -0,0 +1,44 @@
+description = "deep teal, low contrast"
+base = "dark"
+
+[ui]
+background = "#002b36"
+surface = "#073642"
+surface_alt = "#0b3d4b"
+surface_side = "#0e4558"
+surface_peer = "#18445b"
+text = "#c4cbcb"
+muted = "#8c9ca2"
+subtle = "#a8b4b6"
+accent = "#268bd2"
+accent_bright = "#2aa198"
+warning = "#b58900"
+error = "#e25653"
+border = "#14505f"
+focus = "#2aa198"
+selection = "#0f4c5c"
+diff_added = "#859900"
+diff_removed = "#e25653"
+
+[tools]
+read = "#b58900"
+search = "#268bd2"
+image = "#268bd2"
+write = "#d36639"
+delete = "#e25653"
+shell = "#268bd2"
+plan = "#268bd2"
+subagent = "#2aa198"
+message = "#da5495"
+
+[code]
+inline = "#859900"
+text = "#c4cbcb"
+keyword = "#859900"
+string = "#859900"
+comment = "#8c9ca2"
+number = "#d36639"
+function = "#268bd2"
+builtin = "#7b7fca"
+operator = "#a8b4b6"
+punctuator = "#a8b4b6"

zettcode/tui/themes/solarized-light.toml

@@ -0,0 +1,44 @@
+description = "beige with teal-blue accents"
+base = "light"
+
+[ui]
+background = "#fdf6e3"
+surface = "#fffbf0"
+surface_alt = "#eee8d5"
+surface_side = "#dadfd5"
+surface_peer = "#ddd9d3"
+text = "#3e4d52"
+muted = "#677171"
+subtle = "#4c5c62"
+accent = "#227dbd"
+accent_bright = "#23857d"
+warning = "#957100"
+error = "#dc322f"
+border = "#ddd6c1"
+focus = "#23857d"
+selection = "#e4ddc8"
+diff_added = "#6e7e00"
+diff_removed = "#dc322f"
+
+[tools]
+read = "#957100"
+search = "#227dbd"
+image = "#227dbd"
+write = "#cb4b16"
+delete = "#dc322f"
+shell = "#227dbd"
+plan = "#227dbd"
+subagent = "#23857d"
+message = "#d33682"
+
+[code]
+inline = "#6e7e00"
+text = "#3e4d52"
+keyword = "#6e7e00"
+string = "#6e7e00"
+comment = "#677171"
+number = "#cb4b16"
+function = "#227dbd"
+builtin = "#6c71c4"
+operator = "#4c5c62"
+punctuator = "#4c5c62"

zettcode/tui/themes/tokyo-night.toml

@@ -0,0 +1,44 @@
+description = "deep indigo, cool neon blues"
+base = "dark"
+
+[ui]
+background = "#1a1b26"
+surface = "#1f2335"
+surface_alt = "#292e42"
+surface_side = "#313a54"
+surface_peer = "#3c3c5a"
+text = "#c0caf5"
+muted = "#858cab"
+subtle = "#a9b1d6"
+accent = "#7aa2f7"
+accent_bright = "#7dcfff"
+warning = "#e0af68"
+error = "#f7768e"
+border = "#3b4261"
+focus = "#7dcfff"
+selection = "#2f3b66"
+diff_added = "#9ece6a"
+diff_removed = "#f7768e"
+
+[tools]
+read = "#e0af68"
+search = "#7aa2f7"
+image = "#7aa2f7"
+write = "#ff9e64"
+delete = "#f7768e"
+shell = "#7aa2f7"
+plan = "#7aa2f7"
+subagent = "#73daca"
+message = "#bb9af7"
+
+[code]
+inline = "#9ece6a"
+text = "#c0caf5"
+keyword = "#bb9af7"
+string = "#9ece6a"
+comment = "#858cab"
+number = "#ff9e64"
+function = "#7aa2f7"
+builtin = "#bb9af7"
+operator = "#a9b1d6"
+punctuator = "#a9b1d6"

zettcode/tui/widgets/__init__.py

@@ -0,0 +1,121 @@
+"""Reusable widgets built on the core runtime and the layout containers."""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+#: Where each public name lives; read by :func:`__getattr__` on first use.
+_EXPORTS = {
+    "Collapsible": ".collapsible",
+    "Column": ".table",
+    "Completer": ".completion",
+    "CompletionItem": ".completion",
+    "CompletionPopup": ".completion",
+    "ConsolePanel": ".console",
+    "Dialog": ".dialog",
+    "DialogAction": ".dialog",
+    "DiffLine": ".diff",
+    "DiffSegment": ".diff",
+    "DiffView": ".diff",
+    "ListItem": ".list",
+    "ListPage": ".list_page",
+    "ListView": ".list",
+    "Markdown": ".markdown",
+    "MarkdownSource": ".markdown",
+    "MarkdownView": ".markdown",
+    "ProgressBar": ".progress",
+    "RichText": ".rich_text",
+    "Rule": ".text",
+    "Spinner": ".progress",
+    "StatusBar": ".status",
+    "Table": ".table",
+    "TaskPanel": ".tasks",
+    "Text": ".text",
+    "TextArea": ".textarea",
+    "Toast": ".toast",
+    "build_unified": ".diff",
+    "layout_input": ".textarea",
+    "next_word": ".textarea",
+    "parse_unified": ".diff",
+    "previous_word": ".textarea",
+    "render_markdown": ".markdown",
+    "word_diff": ".diff",
+}
+
+
+if TYPE_CHECKING:  # pragma: no cover - for type checkers, not the runtime
+    from .collapsible import Collapsible
+    from .completion import Completer, CompletionItem, CompletionPopup
+    from .console import ConsolePanel
+    from .dialog import Dialog, DialogAction
+    from .diff import DiffLine, DiffSegment, DiffView, build_unified, parse_unified, word_diff
+    from .list import ListItem, ListView
+    from .list_page import ListPage
+    from .markdown import Markdown, MarkdownSource, MarkdownView, render_markdown
+    from .progress import ProgressBar, Spinner
+    from .rich_text import RichText
+    from .status import StatusBar
+    from .table import Column, Table
+    from .tasks import TaskPanel
+    from .text import Rule, Text
+    from .textarea import TextArea, layout_input, next_word, previous_word
+    from .toast import Toast
+
+
+def __getattr__(name: str) -> object:
+    """Import the module a public name lives in, the first time it is asked for.
+
+    This package is a facade over several subpackages, and a caller that wants
+    one name should not pay for the rest of them — the TUI alone holds the
+    widget library, the Markdown parser, the diff viewer, and the syntax
+    scanners. ``__all__`` is still the public surface.
+    """
+    try:
+        module = _EXPORTS[name]
+    except KeyError:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+    return getattr(importlib.import_module(module, __name__), name)
+
+
+def __dir__() -> list[str]:
+    """Return the names this package publishes."""
+    return sorted(__all__)
+
+
+__all__ = [
+    "Collapsible",
+    "Column",
+    "Completer",
+    "CompletionItem",
+    "CompletionPopup",
+    "ConsolePanel",
+    "Dialog",
+    "DialogAction",
+    "DiffLine",
+    "DiffSegment",
+    "DiffView",
+    "ListItem",
+    "ListView",
+    "ListPage",
+    "Markdown",
+    "MarkdownSource",
+    "MarkdownView",
+    "ProgressBar",
+    "RichText",
+    "Rule",
+    "Spinner",
+    "StatusBar",
+    "Table",
+    "TaskPanel",
+    "Text",
+    "TextArea",
+    "Toast",
+    "build_unified",
+    "layout_input",
+    "next_word",
+    "parse_unified",
+    "previous_word",
+    "render_markdown",
+    "word_diff",
+]

zettcode/tui/widgets/collapsible.py

@@ -0,0 +1,116 @@
+"""A header that expands to reveal one child."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+
+from zettcode.tui import EXPANDED, MARKER
+
+from ..core.events import KeyEvent, MouseAction, MouseEvent
+from ..core.geometry import Constraints, Rect, Size
+from ..core.host import Host
+from ..core.widget import Widget
+from ..render import Canvas, Style, truncate
+
+
+class Collapsible(Widget):
+    """Show a title row and, when expanded, a body beneath it.
+
+    Shape::
+
+        > Thinking                        <- collapsed: U+25B8, one row only
+        v Thinking                        <- expanded: U+25BE
+          Checked the renderer.           <- body, directly beneath the header
+
+    Expanding changes the widget's height, so toggling calls
+    ``host.request_layout()``; the body is only a child while it is expanded,
+    which keeps it out of layout and hit testing when collapsed.
+    """
+
+    MARKERS = (MARKER, EXPANDED)
+
+    def __init__(
+        self,
+        title: str = "",
+        body: Widget | None = None,
+        *,
+        expanded: bool = False,
+        on_toggle: Callable[[bool], None] | None = None,
+    ) -> None:
+        """Configure the title, the body, and the initial disclosure state.
+
+        Args:
+            title: Header text drawn after the disclosure marker.
+            body: Child revealed below the header while expanded; ``None`` makes
+                the widget a pure header.
+            expanded: Whether the body starts visible.
+            on_toggle: Called with the new state after every toggle.
+        """
+        super().__init__()
+        self.title = title
+        self.body = body
+        self.expanded = expanded
+        self.on_toggle = on_toggle
+
+    @property
+    def focusable(self) -> bool:
+        """Take focus so Enter and Space can toggle the header."""
+        return True
+
+    @property
+    def children(self) -> tuple[Widget, ...]:
+        """Expose the body only while it is expanded."""
+        return (self.body,) if self.body is not None and self.expanded else ()
+
+    def toggle(self) -> None:
+        """Flip the disclosure state and tell the owner about it."""
+        self.expanded = not self.expanded
+        if self.on_toggle is not None:
+            self.on_toggle(self.expanded)
+
+    def measure(self, constraints: Constraints) -> Size:
+        """Ask for the header row, plus the body while it is expanded."""
+        if self.body is None or not self.expanded:
+            return constraints.constrain(Size(len(self.title) + 2, 1))
+        inner = self.body.measure(constraints)
+        return constraints.constrain(Size(max(len(self.title) + 2, inner.width), 1 + inner.height))
+
+    def layout(self, rect: Rect) -> None:
+        """Reserve the first row for the header and give the rest to the body."""
+        super().layout(rect)
+        if self.body is not None and self.expanded:
+            self.body.layout(Rect(rect.x, rect.y + 1, rect.width, max(0, rect.height - 1)))
+
+    def render(self, canvas: Canvas) -> None:
+        """Paint the header marker and title, then the body when expanded."""
+        if self.rect.empty:
+            return
+        theme = self.theme
+        marker = self.MARKERS[1] if self.expanded else self.MARKERS[0]
+        canvas.draw_text(
+            self.rect.x,
+            self.rect.y,
+            truncate(f"{marker} {self.title}", self.rect.width),
+            Style(foreground=theme.accent, bold=True),
+            max_width=self.rect.width,
+        )
+        if self.body is not None and self.expanded:
+            self.body.render(canvas)
+
+    def handle(self, event, host: Host) -> bool:
+        """Toggle on a click on the header row, or on Enter and Space."""
+        if isinstance(event, MouseEvent):
+            if self.rect.contains(event.x, event.y) and event.y == self.rect.y:
+                if event.action is MouseAction.DOWN:
+                    host.focus(self)
+                    self.toggle()
+                    host.request_layout()
+                    return True
+            return False
+        if not isinstance(event, KeyEvent) or host.focused_widget() is not self:
+            return False
+        if event.key in ("enter", "space"):
+            self.toggle()
+            host.request_layout()
+            return True
+        return False