termflow-md 0.2.2__tar.gz → 0.2.4__tar.gz

{termflow_md-0.2.2 → termflow_md-0.2.4}/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-08-22
+
+### Added
+
+- `RenderStyle.from_palette()` — derive rendering accents from a
+  terminal palette's ANSI slots (Palette object or plain dict), so
+  menus and markdown output stay on-theme when the app has remapped
+  terminal colors via OSC instead of using the hardcoded defaults.
+
+## [0.2.3] - 2026-08-22
+
+### Added
+
+- `termflow.tui.terminal_session()` — refcounted, thread-safe context
+  manager holding raw mode + ONE alternate screen across multiple TUI
+  components. Chained menu flows (a picker opening sub-pickers) run each
+  menu with `alt_screen=False` inside a session and never flash the
+  primary screen between menus. Nested sessions share the outermost one.
+
 ## [0.2.2] - 2026-08-22
 
 ### Fixed

{termflow_md-0.2.2 → termflow_md-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: termflow-md
-Version: 0.2.2
+Version: 0.2.4
 Summary: A streaming markdown renderer for modern terminals
 Project-URL: Homepage, https://github.com/mpfaffenberger/termflow
 Project-URL: Repository, https://github.com/mpfaffenberger/termflow

{termflow_md-0.2.2 → termflow_md-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "termflow-md"
-version = "0.2.2"
+version = "0.2.4"
 description = "A streaming markdown renderer for modern terminals"
 readme = "README.md"
 license = "MIT"

{termflow_md-0.2.2 → termflow_md-0.2.4}/termflow/__init__.py

@@ -31,7 +31,7 @@ CLI usage:
     $ tf --style dracula README.md
 """
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"
 
 from termflow.config import Config
 from termflow.parser import Parser

{termflow_md-0.2.2 → termflow_md-0.2.4}/termflow/render/style.py

@@ -43,6 +43,41 @@ class RenderStyle:
         """Create default style."""
         return cls()
 
+    @classmethod
+    def from_palette(cls, palette) -> RenderStyle:
+        """Derive a style from a terminal palette's ANSI slots.
+
+        Accepts a :class:`termflow.themes.Palette` or any mapping/object
+        exposing ``ansi`` (16 #rrggbb strings, slots 0-15) and optionally
+        ``bg``. Keeps rendered output on-theme when the application has
+        remapped the terminal colors (OSC 4/10/11): accents come from the
+        palette's bright slots instead of the hardcoded defaults.
+
+        Slots with missing colors fall back to the default style's value.
+        """
+        if isinstance(palette, dict):
+            ansi = list(palette.get("ansi") or [])
+            bg = palette.get("bg")
+        else:
+            ansi = list(getattr(palette, "ansi", ()) or ())
+            bg = getattr(palette, "bg", None)
+        base = cls()
+
+        def slot(i: int, fallback: str) -> str:
+            return ansi[i] if i < len(ansi) and ansi[i] else fallback
+
+        return cls(
+            bright=slot(12, base.bright),  # bright blue - primary accent
+            head=slot(10, base.head),  # bright green - secondary
+            symbol=slot(5, base.symbol),  # magenta - markers, borders
+            grey=slot(8, base.grey),  # bright black - dim text
+            dark=bg or slot(0, base.dark),  # background-adjacent
+            mid=slot(0, base.mid),  # block backgrounds
+            light=slot(14, base.light),  # bright cyan - light accent
+            link=slot(12, base.link),  # match primary accent
+            error=slot(9, base.error),  # bright red
+        )
+
     @classmethod
     def from_hue(cls, hue: float) -> RenderStyle:
         """Generate a style from a base hue (0.0-1.0).

{termflow_md-0.2.2 → termflow_md-0.2.4}/termflow/tui/__init__.py

@@ -10,7 +10,12 @@ prompt_toolkit -- just escape sequences and small, injectable pieces.
 
 from termflow.tui.keys import Key, parse_key, read_key
 from termflow.tui.menu import Menu, MenuBuilder, MenuItem, MenuResult
-from termflow.tui.terminal import alt_screen, raw_mode, terminal_size
+from termflow.tui.terminal import (
+    alt_screen,
+    raw_mode,
+    terminal_session,
+    terminal_size,
+)
 
 __all__ = [
     "Key",
@@ -22,5 +27,6 @@ __all__ = [
     "parse_key",
     "raw_mode",
     "read_key",
+    "terminal_session",
     "terminal_size",
 ]

{termflow_md-0.2.2 → termflow_md-0.2.4}/termflow/tui/terminal.py

@@ -12,6 +12,7 @@ from __future__ import annotations
 import contextlib
 import shutil
 import sys
+import threading
 from typing import IO, TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -75,6 +76,50 @@ def raw_mode(stream: IO[str] | None = None) -> Iterator[None]:
             termios.tcsetattr(fd, termios.TCSADRAIN, old)
 
 
+_session_lock = threading.Lock()
+_session_depth = 0
+_session_stack: contextlib.ExitStack | None = None
+
+
+@contextlib.contextmanager
+def terminal_session(output: IO[str] | None = None) -> Iterator[None]:
+    """Hold raw mode + ONE alternate screen across multiple TUI components.
+
+    Menus normally enter/exit the alternate screen per ``run()``; chained
+    flows (a picker opening sub-pickers) would flash the primary screen
+    between every menu. Wrap the whole flow in a ``terminal_session`` and
+    run each menu with ``alt_screen=False``: the session owns the screen
+    and raw mode, the menus just paint.
+
+    Reentrant and refcounted (thread-safe): nested sessions share the
+    outermost one, so components can wrap themselves defensively without
+    caring whether a parent already holds the terminal.
+    """
+    global _session_depth, _session_stack
+    with _session_lock:
+        _session_depth += 1
+        if _session_depth == 1:
+            stack = contextlib.ExitStack()
+            try:
+                stack.enter_context(raw_mode())
+                stack.enter_context(alt_screen(output))
+            except Exception:
+                _session_depth -= 1
+                with contextlib.suppress(Exception):
+                    stack.close()
+                raise
+            _session_stack = stack
+    try:
+        yield
+    finally:
+        with _session_lock:
+            _session_depth -= 1
+            if _session_depth == 0 and _session_stack is not None:
+                stack, _session_stack = _session_stack, None
+                with contextlib.suppress(Exception):
+                    stack.close()
+
+
 @contextlib.contextmanager
 def alt_screen(output: IO[str] | None = None, hide_cursor: bool = True) -> Iterator[None]:
     """Switch to the alternate screen buffer (like vim/less) for the duration.

termflow_md-0.2.4/tests/test_style.py

@@ -0,0 +1,28 @@
+class TestFromPalette:
+    def test_derives_accents_from_ansi_slots(self):
+        from termflow.render.style import RenderStyle
+        from termflow.themes import get_palette
+
+        pal = get_palette("purple_puppy")
+        style = RenderStyle.from_palette(pal)
+        assert style.bright == pal.ansi[12]
+        assert style.symbol == pal.ansi[5]
+        assert style.error == pal.ansi[9]
+        assert style.dark == pal.bg
+
+    def test_accepts_plain_dict(self):
+        from termflow.render.style import RenderStyle
+
+        ansi = [f"#0000{i:02x}" for i in range(16)]
+        style = RenderStyle.from_palette({"ansi": ansi, "bg": "#101010"})
+        assert style.bright == ansi[12]
+        assert style.grey == ansi[8]
+        assert style.dark == "#101010"
+
+    def test_missing_slots_fall_back_to_defaults(self):
+        from termflow.render.style import RenderStyle
+
+        base = RenderStyle.default()
+        style = RenderStyle.from_palette({"ansi": []})
+        assert style.bright == base.bright
+        assert style.error == base.error

{termflow_md-0.2.2 → termflow_md-0.2.4}/tests/test_tui.py

@@ -9,6 +9,52 @@ from termflow.tui import Key, MenuBuilder, MenuItem, parse_key
 # =============================================================================
 # Key parsing
 # =============================================================================
+class TestTerminalSession:
+    """Refcounted raw-mode + alt-screen session for chained menus."""
+
+    def test_single_session_enters_and_exits_once(self):
+        from io import StringIO
+
+        from termflow.tui import terminal_session
+
+        out = StringIO()
+        with terminal_session(out):
+            pass
+        assert out.getvalue().count("\x1b[?1049h") == 1
+        assert out.getvalue().count("\x1b[?1049l") == 1
+
+    def test_nested_sessions_share_one_alt_screen(self):
+        from io import StringIO
+
+        from termflow.tui import terminal_session
+
+        out = StringIO()
+        with terminal_session(out):
+            with terminal_session(out):
+                pass
+            # Inner exit must NOT drop back to the primary screen.
+            assert out.getvalue().count("\x1b[?1049l") == 0
+        assert out.getvalue().count("\x1b[?1049h") == 1
+        assert out.getvalue().count("\x1b[?1049l") == 1
+
+    def test_session_releases_on_exception(self):
+        from io import StringIO
+
+        from termflow.tui import terminal_session
+
+        out = StringIO()
+        try:
+            with terminal_session(out):
+                raise RuntimeError("boom")
+        except RuntimeError:
+            pass
+        assert out.getvalue().count("\x1b[?1049l") == 1
+        # Depth back to zero: a fresh session works.
+        with terminal_session(out):
+            pass
+        assert out.getvalue().count("\x1b[?1049h") == 2
+
+
 class TestParseKey:
     def test_printable_passthrough(self):
         assert parse_key("a") == "a"

{termflow_md-0.2.2 → termflow_md-0.2.4}/uv.lock

@@ -747,7 +747,7 @@ wheels = [
 
 [[package]]
 name = "termflow-md"
-version = "0.2.1"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "pygments" },