termrender 0.1.0__tar.gz → 0.3.0__tar.gz

termrender-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Release & Publish
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    outputs:
+      released: ${{ steps.semrel.outputs.released }}
+      tag: ${{ steps.semrel.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: python-semantic-release/python-semantic-release@v9
+        id: semrel
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          git_committer_name: "github-actions[bot]"
+          git_committer_email: "github-actions[bot]@users.noreply.github.com"
+
+  publish:
+    needs: release
+    if: needs.release.outputs.released == 'true'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ needs.release.outputs.tag }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

termrender-0.3.0/CHANGELOG.md

@@ -0,0 +1,119 @@
+# CHANGELOG
+
+
+## v0.3.0 (2026-04-05)
+
+### Documentation
+
+- Update CLAUDE.md notes for mermaid, tmux, and layout
+  ([`9e104d5`](https://github.com/CaptainCrouton89/termrender/commit/9e104d5ee7bad9a57902e79586c02b0e8d80c589))
+
+### Features
+
+- **cli**: Auto-size tmux pane to fit rendered content
+  ([`91f0414`](https://github.com/CaptainCrouton89/termrender/commit/91f0414d0bf8bfbe4d7167159b928ed9c736db74))
+
+- **mermaid**: Pass width and vertical padding to mermaid-ascii
+  ([`96145c2`](https://github.com/CaptainCrouton89/termrender/commit/96145c2789a52a4d94e9bc5f4adf7f3a88d8501f))
+
+- **table**: Auto-wrap cell content when columns overflow
+  ([`0fae56f`](https://github.com/CaptainCrouton89/termrender/commit/0fae56f8f00260c3263671df9a63a5bea17820bb))
+
+When a table exceeds available width, cells now wrap text within their proportionally-shrunk column
+  widths instead of overflowing. Layout height calculation updated to account for multi-line cells.
+
+
+## v0.2.1 (2026-04-05)
+
+### Bug Fixes
+
+- **mermaid**: Undo double-encoded UTF-8 from mermaid-ascii output
+  ([`9e0560c`](https://github.com/CaptainCrouton89/termrender/commit/9e0560ce46b6dc3f90d2d716a97780713e5e5e53))
+
+mermaid-ascii misinterprets UTF-8 bytes as Latin-1 and re-encodes, corrupting multi-byte characters
+  (e.g. → renders as â<U+0086><U+0092>). Apply latin-1 round-trip to recover original UTF-8 in both
+  layout and renderer subprocess call sites.
+
+### Documentation
+
+- Add tmux pane lifecycle and --check interaction notes to CLAUDE.md
+  ([`9400092`](https://github.com/CaptainCrouton89/termrender/commit/9400092e507d470acb97ac5a17b66fcf0e9aa2f6))
+
+
+## v0.2.0 (2026-04-05)
+
+### Bug Fixes
+
+- Handle zero-width and emoji presentation chars in visual width calculation
+  ([`d0bb8dc`](https://github.com/CaptainCrouton89/termrender/commit/d0bb8dcfa5ca0d2c16d78a1d7f81825231b9cb59))
+
+_char_width now returns 0 for combining marks and format characters (ZWJ, variation selectors).
+  visual_len handles VS16 emoji presentation sequences by promoting the preceding character to width
+  2. Fixes panel border misalignment when content contains emoji or special Unicode.
+
+- **docs**: Update README output examples to match actual rendered output
+  ([`de6d0cc`](https://github.com/CaptainCrouton89/termrender/commit/de6d0ccfd8a60aca20f2b2659a313f8d8c87d853))
+
+### Chores
+
+- Add README, design specs, and project CLAUDE.md files
+  ([`93ac358`](https://github.com/CaptainCrouton89/termrender/commit/93ac35857981c549797a9359573cacea1478b3ad))
+
+- Derive version from git tags via hatch-vcs
+  ([`33595a0`](https://github.com/CaptainCrouton89/termrender/commit/33595a0b64363e445b90c9df135a50a4652e2bae))
+
+### Continuous Integration
+
+- Auto-release and publish via conventional commits
+  ([`80a456b`](https://github.com/CaptainCrouton89/termrender/commit/80a456b7301c57f2fd2b0cd30622b78f2d4b931e))
+
+Replace manual GitHub release trigger with python-semantic-release. On push to main, conventional
+  commits are analyzed to determine version bumps (feat→minor, fix→patch) and publish to PyPI
+  automatically.
+
+### Documentation
+
+- Update README token count and expand CLAUDE.md implementation notes
+  ([`1f70a53`](https://github.com/CaptainCrouton89/termrender/commit/1f70a5352cbced30219012dbede7040c6ac97457))
+
+### Features
+
+- Add CJK ambiguous-width support, strict directive parsing, and rendering fixes
+  ([`c000883`](https://github.com/CaptainCrouton89/termrender/commit/c0008835d66b721b0a09c7a34dde11d08b3d3d94))
+
+- Add emoji presentation and East Asian ambiguous-width character handling with --cjk flag and
+  TERMRENDER_CJK env var - All renderers (borders, divider, quote, tree) now compute box-drawing
+  character widths dynamically via visual_len - Parser raises DirectiveError on unclosed or stray
+  ::: directives instead of silently degrading - Fix column width distribution to correctly account
+  for inter-column gaps - Support 'author' as alias for 'by' attribute on quote blocks
+
+- Add GFM table rendering with box-drawing borders
+  ([`c3b61cd`](https://github.com/CaptainCrouton89/termrender/commit/c3b61cdd659fdb782089cbca2fd3f74b18486605))
+
+Enable mistune table plugin, parse table AST into TABLE blocks, and render with box-drawing
+  characters. Supports left/center/right column alignment, bold headers, auto-sized columns, and
+  proportional overflow distribution.
+
+- **cli**: Add --tmux pane output, --check validation, and structured error handling
+  ([`36b52ee`](https://github.com/CaptainCrouton89/termrender/commit/36b52eed9701cd0acd363db2d0fa3d277244c8b0))
+
+- --tmux renders in a new tmux side pane via split-window, piped through less -R - --check validates
+  directive syntax without rendering (exit 0/2) - Structured _error() helper with fix/hint guidance
+  on stderr - Named exit codes (EXIT_OK, EXIT_INPUT, EXIT_SYNTAX, EXIT_TERMINAL) - Expanded epilog
+  with full directive reference, nesting examples, and env docs - Dynamic version from
+  importlib.metadata (hatch-vcs) - Updated CLAUDE.md to document --check behavior and fix recursion
+  depth note
+
+- **cli**: Improve help output with examples, version flag, and tty detection
+  ([`cb3e7e2`](https://github.com/CaptainCrouton89/termrender/commit/cb3e7e2752ae860e5c3cbd4c4f1627e925a9c431))
+
+### Testing
+
+- Add column alignment and visual width tests
+  ([`f8b6099`](https://github.com/CaptainCrouton89/termrender/commit/f8b60998625977b10dd4697f8e772d80125cb9ce))
+
+Covers showpiece rendering, column line width consistency, status marker visual widths (text vs
+  emoji presentation), and panel border alignment.
+
+
+## v0.1.0 (2026-04-04)

termrender-0.3.0/CLAUDE.md

@@ -0,0 +1,64 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What this is
+
+termrender renders directive-flavored markdown to ANSI terminal output. LLM agents describe layout with `:::directives` (panels, columns, trees, callouts, etc.) and termrender produces styled terminal output. Public API: `from termrender import render`.
+
+## Commands
+
+```bash
+# Install in dev mode
+pip install -e .
+
+# Run tests
+pytest tests/
+pytest tests/test_column_alignment.py::TestColumnAlignment::test_showpiece_renders_without_error
+
+# Run the CLI
+python -m termrender <file.md>
+echo ':::panel{title="Hi"}\nHello\n:::' | python -m termrender
+
+# Build
+python -m build
+```
+
+No linter or formatter is configured.
+
+## Architecture
+
+Three-stage pipeline: **parse → layout → emit**.
+
+1. **Parse** (`parser.py`) — Two-pass: regex extracts `:::directives` first, then mistune v3 processes markdown segments. Produces a tree of `Block` dataclasses (`blocks.py`).
+2. **Layout** (`layout.py`) — Two-pass, order is load-bearing: `resolve_width()` top-down, then `resolve_height()` bottom-up. Width must resolve first because height calls `wrap_text(text, width)`.
+3. **Emit** (`emit.py`) — Walks the block tree and dispatches to renderer functions in `renderers/`.
+
+Entry points:
+- **Library**: `__init__.py:render()` — parse → layout → emit
+- **CLI**: `__main__.py:main()` — argparse with `--width`, `--no-color`, `--check`, `--cjk`, `--tmux`. Exit codes: 0=ok, 1=input, 2=syntax, 3=terminal.
+
+### Renderers (`src/termrender/renderers/`)
+
+Two signatures (not type-enforced):
+- **Leaf**: `render(block, color) -> list[str]` — divider, tree
+- **Container**: `render(block, color, render_child) -> list[str]` — panel, quote, code, columns, callout, table, text, mermaid
+
+`borders.py` is a shared utility, not a renderer. Its `render_box(content_lines, width, ...)` takes **total** width (including borders), not content width.
+
+### Style (`style.py`)
+
+`visual_len()` measures display width accounting for ANSI escapes, emoji, CJK, and combining marks. `wrap_text()` uses `len()` internally (known bug: CJK overflow). `_ambiguous_width` is global mutable state with no reset path — set via `set_ambiguous_width()` or `TERMRENDER_CJK` env var.
+
+## Conventions
+
+- **Commits**: conventional commits (`feat:`, `fix:`, `chore:`, etc.). `feat` → minor, `fix`/`perf` → patch. Auto-released via python-semantic-release on main.
+- **Version**: derived from git tags via hatch-vcs (no version in pyproject.toml).
+- **Python**: 3.10+.
+
+## Supplementary CLAUDE.md files
+
+- `src/termrender/CLAUDE.md` — parser, layout, mermaid, nesting, and `--check`/`--tmux` implementation gotchas
+- `src/termrender/renderers/CLAUDE.md` — renderer contracts, `render_box` width semantics, EAW edge cases
+
+Read these before modifying layout, parsing, or renderer code.