termrender 0.7.3__tar.gz → 1.0.0__tar.gz

termrender-1.0.0/.git

@@ -0,0 +1 @@
+gitdir: /Users/silasrhyneer/Code/cli/termrender/.git/worktrees/tr-v100

{termrender-0.7.3 → termrender-1.0.0}/CHANGELOG.md

@@ -1,18 +1,93 @@
 # CHANGELOG
 
 
+## v1.0.0 (2026-04-27)
+
+### Documentation
+
+- **claude-md**: Tighten root and src CLAUDE.md
+  ([`7fe01ec`](https://github.com/crouton-labs/termrender/commit/7fe01ec2da0c7a0c1aa0f4eccf9b958496562be8))
+
+### Features
+
+- **mermaid**: Switch to :::mermaid directive, drop backtick fence forms
+  ([`083f590`](https://github.com/crouton-labs/termrender/commit/083f5900b4b516f9df599dd08129afee34310e3d))
+
+BREAKING CHANGE: ```mermaid fenced code blocks are no longer rendered as mermaid diagrams — they now
+  render as plain code blocks. Mermaid diagrams must use the new :::mermaid directive. The
+  MyST-style ```{name} backtick directive form is also removed; backtick fences now always produce a
+  code block, regardless of the language tag. Every directive uses ::: exclusively.
+
+### Breaking Changes
+
+- **mermaid**: ```mermaid fenced code blocks are no longer rendered as mermaid diagrams — they now
+  render as plain code blocks. Mermaid diagrams must use the new :::mermaid directive. The
+  MyST-style ```{name} backtick directive form is also removed; backtick fences now always produce a
+  code block, regardless of the language tag. Every directive uses ::: exclusively.
+
+
+## v0.9.1 (2026-04-25)
+
+### Bug Fixes
+
+- **timeline**: Wrap event text instead of truncating with ellipsis
+  ([`5af0e04`](https://github.com/crouton-labs/termrender/commit/5af0e04c3256075a2016e2cf8ae3d44e9e78c8fc))
+
+Long event entries previously got clipped with `…` when they exceeded event_w. Now they wrap across
+  multiple lines, with continuation lines indented under the bullet and prefixed by the accent bar.
+  Layout height sums per-entry wrapped line counts so the block reserves the right space.
+
+
+## v0.9.0 (2026-04-21)
+
+### Bug Fixes
+
+- **wrap**: Honor hard line breaks in wrap_text
+  ([`a383f4d`](https://github.com/crouton-labs/termrender/commit/a383f4de66b3d8370bda500dd4c3771a591563aa))
+
+Markdown hard breaks were parsed as \n spans but wrap_text only split on spaces, leaking raw \n into
+  wrapped output. Inside panels and columns this broke border alignment because visual_ljust padded
+  the string once, not per visual line.
+
+wrap_text now recursively wraps each \n-separated segment; the text-renderer offset heuristic skips
+  \n as well as space between lines. Layout height calcs pick up the extra lines automatically.
+
+### Features
+
+- **spacing**: Add blank lines between hard breaks and top-level blocks
+  ([`7610189`](https://github.com/crouton-labs/termrender/commit/761018928504cf9626678fe46b5ee66d5e899d5d))
+
+Hard line breaks now render a blank line between the two sides (parser emits \n\n so wrap_text
+  naturally produces the gap), and DOCUMENT-level siblings are separated by a blank padded line so
+  paragraphs, headings, and blocks no longer visually run together.
+
+
+## v0.8.0 (2026-04-18)
+
+### Features
+
+- **mermaid**: Preprocess sequence diagrams for mermaid-ascii compatibility
+  ([`a642576`](https://github.com/crouton-labs/termrender/commit/a642576d41d5dbde372d7de2ab47745296a78e32))
+
+mermaid-ascii only parses ->> / -->> arrows, participants, and self-loops; every other common
+  sequence-diagram construct made it fail and fall back to raw source. Rewrite Note lines into
+  self-loops, map -> / -x / --x / -) / --) / -- > onto the supported arrow pair, drop block keywords
+  (loop/alt/activate/ autonumber/end/…), and flatten <br/> to ' / '. Non-sequence diagrams pass
+  through unchanged.
+
+
 ## v0.7.3 (2026-04-15)
 
 ### Bug Fixes
 
 - **code**: Wrap long code lines to fit layout width
-  ([`31c6e59`](https://github.com/CaptainCrouton89/termrender/commit/31c6e595a438c4ced8c61fff679b59d4ae55f938))
+  ([`31c6e59`](https://github.com/crouton-labs/termrender/commit/31c6e595a438c4ced8c61fff679b59d4ae55f938))
 
 Code blocks previously used raw line count for height and let render_box grow beyond the layout
   allocation. Now wraps source lines to the available content width in both layout and renderer.
 
 - **parser**: Add directive trace and file-absolute line numbers to error messages
-  ([`0f99ea0`](https://github.com/CaptainCrouton89/termrender/commit/0f99ea0310116f8fa06e933cd26126246d7a3b43))
+  ([`0f99ea0`](https://github.com/crouton-labs/termrender/commit/0f99ea0310116f8fa06e933cd26126246d7a3b43))
 
 Stray-closer and unclosed-directive errors now print the full open/close trace and, when nested
   directives share a colon count, name the specific cause and suggest the fix. Recursive body
@@ -25,7 +100,7 @@ Stray-closer and unclosed-directive errors now print the full open/close trace a
 ### Bug Fixes
 
 - **cli**: Default --tmux pane to 1/3 window width
-  ([`d9c1bcc`](https://github.com/CaptainCrouton89/termrender/commit/d9c1bccbe95a4e5cf1f975b82cbafde6d9d3807a))
+  ([`d9c1bcc`](https://github.com/crouton-labs/termrender/commit/d9c1bccbe95a4e5cf1f975b82cbafde6d9d3807a))
 
 Instead of preview-rendering at 80 cols to measure content width, default to (window_width - 2) // 3
   for a consistent 1/3 split.
@@ -36,7 +111,7 @@ Instead of preview-rendering at 80 cols to measure content width, default to (wi
 ### Bug Fixes
 
 - **cli**: Give --pane error paths actionable recovery guidance
-  ([`f857c32`](https://github.com/CaptainCrouton89/termrender/commit/f857c32c89afe32a3a668f03a3d570b0f14dae97))
+  ([`f857c32`](https://github.com/crouton-labs/termrender/commit/f857c32c89afe32a3a668f03a3d570b0f14dae97))
 
 The two --pane error paths now tell the agent how to recover instead of restating the problem.
   "Check that the pane id is valid" is a dead end for an agent — it needs either a command to list
@@ -48,7 +123,7 @@ The two --pane error paths now tell the agent how to recover instead of restatin
 ### Features
 
 - **cli**: Add --pane for in-place tmux pane updates
-  ([`4ab1d77`](https://github.com/CaptainCrouton89/termrender/commit/4ab1d77b996aa356926407dcc11c1b408e68e0ee))
+  ([`4ab1d77`](https://github.com/crouton-labs/termrender/commit/4ab1d77b996aa356926407dcc11c1b408e68e0ee))
 
 --tmux now prints the newly-created pane id to stdout (via split-window -P -F) so callers can
   capture it for subsequent updates. --pane <ID> targets an existing pane via tmux respawn-pane -k
@@ -68,7 +143,7 @@ Also in this commit: - Expand -h epilog to cover the 8 visualization directives
 ### Bug Fixes
 
 - **borders**: Grow render_box to fit overflowing content and titles
-  ([`dc108c8`](https://github.com/CaptainCrouton89/termrender/commit/dc108c8242763828245569f719abce64b26ddf5b))
+  ([`dc108c8`](https://github.com/crouton-labs/termrender/commit/dc108c8242763828245569f719abce64b26ddf5b))
 
 mermaid-ascii's --maxWidth is non-strict, so a child mermaid block can return lines wider than the
   panel's allocated content area. Previously the side walls floated outward to accommodate the
@@ -85,7 +160,7 @@ render_box now measures the widest content line (and the title) and grows its ef
 ### Features
 
 - Add diff, charts, stat, timeline, tasklist, and inline badges
-  ([`e14f615`](https://github.com/CaptainCrouton89/termrender/commit/e14f615ae8d0723405db61c79b0f858d7bf0f863))
+  ([`e14f615`](https://github.com/crouton-labs/termrender/commit/e14f615ae8d0723405db61c79b0f858d7bf0f863))
 
 New block-level directives: - :::diff — colored unified diff with +/- gutters - :::bar — multi-bar
   chart with sub-cell precision via eighth blocks - :::progress — single-line progress bar (auto
@@ -108,7 +183,7 @@ Cross-cutting changes: - InlineSpan gained fg/bg fields; render_spans and span-s
 63 new tests across six test files. All 94 tests pass.
 
 - **cli**: Add --watch mode for live re-rendering
-  ([`4223ad8`](https://github.com/CaptainCrouton89/termrender/commit/4223ad86805b0b3ad45450bd7ca4441a668f0e23))
+  ([`4223ad8`](https://github.com/crouton-labs/termrender/commit/4223ad86805b0b3ad45450bd7ca4441a668f0e23))
 
 Re-renders the file whenever its mtime changes, with terminal-resize detection and inline error
   display so the watcher survives malformed input. Uses the alternate screen buffer so Ctrl+C
@@ -120,7 +195,7 @@ Composes with --tmux: --tmux --watch points the spawned pane at the real file pa
 ### Refactoring
 
 - **parser**: Require strictly more colons on outer fences
-  ([`4a501d9`](https://github.com/CaptainCrouton89/termrender/commit/4a501d917db191f758874bb6c3d922c879a763be))
+  ([`4a501d9`](https://github.com/crouton-labs/termrender/commit/4a501d917db191f758874bb6c3d922c879a763be))
 
 Drops the depth-counter that allowed `:::outer ... :::inner ... ::: ... :::` nesting with same colon
   counts. Termrender now matches the standard followed by MyST, Pandoc fenced divs,
@@ -140,7 +215,7 @@ Fixtures in test_column_alignment.py rewritten to ascending colon counts (7/6/5/
 ### Features
 
 - **table**: Render horizontal separator lines between data rows
-  ([`3e4c74a`](https://github.com/CaptainCrouton89/termrender/commit/3e4c74a10d63470f2eb2ec096bb47cf41f0b7f70))
+  ([`3e4c74a`](https://github.com/crouton-labs/termrender/commit/3e4c74a10d63470f2eb2ec096bb47cf41f0b7f70))
 
 
 ## v0.4.0 (2026-04-05)
@@ -148,7 +223,7 @@ Fixtures in test_column_alignment.py rewritten to ascending colon counts (7/6/5/
 ### Features
 
 - **parser**: Variable colon counts, backtick fence directives, and gloam-inspired theming
-  ([`47fac7f`](https://github.com/CaptainCrouton89/termrender/commit/47fac7fcf13d33e5d9986d3f9ca42ddaf5e7207d))
+  ([`47fac7f`](https://github.com/crouton-labs/termrender/commit/47fac7fcf13d33e5d9986d3f9ca42ddaf5e7207d))
 
 Parser changes: - Support 3+ colon openers/closers with stack-based matching - Backtick fence
   directive syntax (```{name}) via mistune AST interception - Option line stripping (:key: value)
@@ -170,18 +245,18 @@ Theming (gloam-inspired defaults): - Headings: depth-based colored fg + dim tint
 ### Documentation
 
 - Update CLAUDE.md notes for mermaid, tmux, and layout
-  ([`9e104d5`](https://github.com/CaptainCrouton89/termrender/commit/9e104d5ee7bad9a57902e79586c02b0e8d80c589))
+  ([`9e104d5`](https://github.com/crouton-labs/termrender/commit/9e104d5ee7bad9a57902e79586c02b0e8d80c589))
 
 ### Features
 
 - **cli**: Auto-size tmux pane to fit rendered content
-  ([`91f0414`](https://github.com/CaptainCrouton89/termrender/commit/91f0414d0bf8bfbe4d7167159b928ed9c736db74))
+  ([`91f0414`](https://github.com/crouton-labs/termrender/commit/91f0414d0bf8bfbe4d7167159b928ed9c736db74))
 
 - **mermaid**: Pass width and vertical padding to mermaid-ascii
-  ([`96145c2`](https://github.com/CaptainCrouton89/termrender/commit/96145c2789a52a4d94e9bc5f4adf7f3a88d8501f))
+  ([`96145c2`](https://github.com/crouton-labs/termrender/commit/96145c2789a52a4d94e9bc5f4adf7f3a88d8501f))
 
 - **table**: Auto-wrap cell content when columns overflow
-  ([`0fae56f`](https://github.com/CaptainCrouton89/termrender/commit/0fae56f8f00260c3263671df9a63a5bea17820bb))
+  ([`0fae56f`](https://github.com/crouton-labs/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.
@@ -192,7 +267,7 @@ When a table exceeds available width, cells now wrap text within their proportio
 ### Bug Fixes
 
 - **mermaid**: Undo double-encoded UTF-8 from mermaid-ascii output
-  ([`9e0560c`](https://github.com/CaptainCrouton89/termrender/commit/9e0560ce46b6dc3f90d2d716a97780713e5e5e53))
+  ([`9e0560c`](https://github.com/crouton-labs/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
@@ -201,7 +276,7 @@ mermaid-ascii misinterprets UTF-8 bytes as Latin-1 and re-encodes, corrupting mu
 ### Documentation
 
 - Add tmux pane lifecycle and --check interaction notes to CLAUDE.md
-  ([`9400092`](https://github.com/CaptainCrouton89/termrender/commit/9400092e507d470acb97ac5a17b66fcf0e9aa2f6))
+  ([`9400092`](https://github.com/crouton-labs/termrender/commit/9400092e507d470acb97ac5a17b66fcf0e9aa2f6))
 
 
 ## v0.2.0 (2026-04-05)
@@ -209,27 +284,27 @@ mermaid-ascii misinterprets UTF-8 bytes as Latin-1 and re-encodes, corrupting mu
 ### Bug Fixes
 
 - Handle zero-width and emoji presentation chars in visual width calculation
-  ([`d0bb8dc`](https://github.com/CaptainCrouton89/termrender/commit/d0bb8dcfa5ca0d2c16d78a1d7f81825231b9cb59))
+  ([`d0bb8dc`](https://github.com/crouton-labs/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))
+  ([`de6d0cc`](https://github.com/crouton-labs/termrender/commit/de6d0ccfd8a60aca20f2b2659a313f8d8c87d853))
 
 ### Chores
 
 - Add README, design specs, and project CLAUDE.md files
-  ([`93ac358`](https://github.com/CaptainCrouton89/termrender/commit/93ac35857981c549797a9359573cacea1478b3ad))
+  ([`93ac358`](https://github.com/crouton-labs/termrender/commit/93ac35857981c549797a9359573cacea1478b3ad))
 
 - Derive version from git tags via hatch-vcs
-  ([`33595a0`](https://github.com/CaptainCrouton89/termrender/commit/33595a0b64363e445b90c9df135a50a4652e2bae))
+  ([`33595a0`](https://github.com/crouton-labs/termrender/commit/33595a0b64363e445b90c9df135a50a4652e2bae))
 
 ### Continuous Integration
 
 - Auto-release and publish via conventional commits
-  ([`80a456b`](https://github.com/CaptainCrouton89/termrender/commit/80a456b7301c57f2fd2b0cd30622b78f2d4b931e))
+  ([`80a456b`](https://github.com/crouton-labs/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
@@ -238,12 +313,12 @@ Replace manual GitHub release trigger with python-semantic-release. On push to m
 ### Documentation
 
 - Update README token count and expand CLAUDE.md implementation notes
-  ([`1f70a53`](https://github.com/CaptainCrouton89/termrender/commit/1f70a5352cbced30219012dbede7040c6ac97457))
+  ([`1f70a53`](https://github.com/crouton-labs/termrender/commit/1f70a5352cbced30219012dbede7040c6ac97457))
 
 ### Features
 
 - Add CJK ambiguous-width support, strict directive parsing, and rendering fixes
-  ([`c000883`](https://github.com/CaptainCrouton89/termrender/commit/c0008835d66b721b0a09c7a34dde11d08b3d3d94))
+  ([`c000883`](https://github.com/crouton-labs/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
@@ -252,14 +327,14 @@ Replace manual GitHub release trigger with python-semantic-release. On push to m
   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))
+  ([`c3b61cd`](https://github.com/crouton-labs/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))
+  ([`36b52ee`](https://github.com/crouton-labs/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
@@ -269,12 +344,12 @@ Enable mistune table plugin, parse table AST into TABLE blocks, and render with
   depth note
 
 - **cli**: Improve help output with examples, version flag, and tty detection
-  ([`cb3e7e2`](https://github.com/CaptainCrouton89/termrender/commit/cb3e7e2752ae860e5c3cbd4c4f1627e925a9c431))
+  ([`cb3e7e2`](https://github.com/crouton-labs/termrender/commit/cb3e7e2752ae860e5c3cbd4c4f1627e925a9c431))
 
 ### Testing
 
 - Add column alignment and visual width tests
-  ([`f8b6099`](https://github.com/CaptainCrouton89/termrender/commit/f8b60998625977b10dd4697f8e772d80125cb9ce))
+  ([`f8b6099`](https://github.com/crouton-labs/termrender/commit/f8b60998625977b10dd4697f8e772d80125cb9ce))
 
 Covers showpiece rendering, column line width consistency, status marker visual widths (text vs
   emoji presentation), and panel border alignment.

termrender-1.0.0/CLAUDE.md

@@ -0,0 +1,25 @@
+# termrender
+
+## Commands
+```bash
+pip install -e .
+pytest tests/
+python -m termrender <file.md>
+python -m build
+```
+
+No linter or formatter is configured.
+
+## Constraints
+- **Layout pass order is load-bearing**: `resolve_width()` top-down must complete before `resolve_height()` bottom-up — height calls `wrap_text(text, width)`, which requires width already set.
+- **`borders.py` `render_box` width**: takes **total** width including borders, not content width. Passing content width silently overflows.
+- **`wrap_text()` CJK bug**: uses `len()` internally, not `visual_len()` — silently overflows for CJK content.
+- **`_ambiguous_width` is global mutable state** with no reset path — `set_ambiguous_width()` or `TERMRENDER_CJK` env var changes persist for the process lifetime.
+- **Version**: derived from git tags via hatch-vcs — no version in `pyproject.toml`. Adding one will conflict.
+- **Commits**: conventional commits. `feat` → minor, `fix`/`perf` → patch. Auto-released via python-semantic-release on main.
+
+## 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.

{termrender-0.7.3 → termrender-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termrender
-Version: 0.7.3
+Version: 1.0.0
 Summary: Rich terminal rendering of directive-flavored markdown
 Project-URL: Homepage, https://github.com/CaptainCrouton89/termrender
 Project-URL: Repository, https://github.com/CaptainCrouton89/termrender
@@ -393,17 +393,17 @@ Horizontal rules with optional centered labels.
 
 ### Mermaid diagrams
 
-Renders mermaid flowcharts as ASCII art via [mermaid-ascii](https://github.com/mermaid-js/mermaid-ascii). Use standard mermaid fenced code blocks.
+Renders mermaid flowcharts as ASCII art via [mermaid-ascii](https://github.com/mermaid-js/mermaid-ascii). Mermaid uses the `:::mermaid` directive — backtick fences (`` ```mermaid ``) are treated as plain code blocks.
 
 **Input:**
-````markdown
-```mermaid
+```markdown
+:::mermaid
 graph LR
     A[Request] --> B{Auth?}
     B -->|Yes| C[Handler]
     B -->|No| D[401]
+:::
 ```
-````
 
 The diagram gets rendered as ASCII art inline in the terminal output. Requires `mermaid-ascii` to be installed (it's a dependency, so it should be).
 

{termrender-0.7.3 → termrender-1.0.0}/README.md

@@ -365,17 +365,17 @@ Horizontal rules with optional centered labels.
 
 ### Mermaid diagrams
 
-Renders mermaid flowcharts as ASCII art via [mermaid-ascii](https://github.com/mermaid-js/mermaid-ascii). Use standard mermaid fenced code blocks.
+Renders mermaid flowcharts as ASCII art via [mermaid-ascii](https://github.com/mermaid-js/mermaid-ascii). Mermaid uses the `:::mermaid` directive — backtick fences (`` ```mermaid ``) are treated as plain code blocks.
 
 **Input:**
-````markdown
-```mermaid
+```markdown
+:::mermaid
 graph LR
     A[Request] --> B{Auth?}
     B -->|Yes| C[Handler]
     B -->|No| D[401]
+:::
 ```
-````
 
 The diagram gets rendered as ASCII art inline in the terminal output. Requires `mermaid-ascii` to be installed (it's a dependency, so it should be).
 

termrender-1.0.0/src/termrender/CLAUDE.md

@@ -0,0 +1,15 @@
+- `layout.py` imports `fix_mermaid_encoding` and `preprocess_mermaid_for_ascii` from `renderers/mermaid.py` — the only reverse dependency from layout into renderers. Reorganizing `renderers/` must preserve these imports. The two mermaid subprocess call sites differ: layout uses `check=True` (non-zero exit raises → caught → raw-source fallback); the renderer omits `check` (non-zero exit silently reads `stdout`, which may be empty or partial).
+
+- `--check` calls `parse()` and exits — it never runs `layout.py`. Layout-time failures (mermaid subprocess missing, column percent overflow, `resolve_width`/`resolve_height` exceptions) pass `--check` cleanly but crash at render time.
+
+- Column widths: explicit percent/absolute allocations are subtracted first; remaining space is split among auto-width columns with `max(remaining, 0)`. Two columns each claiming 80% of a 100px terminal leaves auto-width columns with `width = 1` — no error, no proportional scaling.
+
+- **QUOTE** height gets `+1` only when `author` or `by` attr is set. Using any other key (`attribution`, `source`) silently omits the extra line — the renderer's attribution line is clipped.
+
+- **LIST_ITEM** layout wraps at `max(width - 2, 1)`, hardcoding a 2-column indent. If the renderer changes the indent width, layout height and actual render height diverge silently.
+
+- `text.py:32–33`: after each wrapped line, the offset skips one character if the next plain-text character is a space (the space `wrap_text` consumed). If wrapping preserves trailing spaces, this skip shifts subsequent span styling by one character.
+
+- `--tmux` exits `EXIT_OK` after the tmux pane command succeeds — the `--check` branch comes later and is never reached. `--check` is silently dropped when combined with `--tmux`.
+
+- `_EMOJI_WIDE_RANGES` in `style.py`: `_char_width()` exits early when `cp < lo`, assuming ranges are in ascending codepoint order. Adding a range out of order silently misclassifies all codepoints whose `lo` is higher than the inserted range's `lo`.

{termrender-0.7.3 → termrender-1.0.0}/src/termrender/__main__.py

@@ -53,7 +53,8 @@ directives (close each with a matching colon count):
   :::tasklist                        Checkbox list — [x] checked, [ ] unchecked, [!] in-progress
       Plain lists with at least one marker auto-promote; use the directive
       to force unchecked styling on items without explicit markers.
-  ```mermaid ... ```                  Mermaid diagram (via mermaid-ascii)
+  :::mermaid                         Mermaid diagram (via mermaid-ascii)
+      body: standard mermaid source (graph TD, flowchart, sequenceDiagram, ...)
 
   Inline:
   :badge[text]{color=c}              Inline pill badge
@@ -335,18 +336,27 @@ def main() -> None:
             if args.width:
                 pane_width = args.width
             else:
-                # Default: 1/3 of window width (minus separator)
+                # Default sizing aims for a readable side pane (~80 cols) and
+                # only falls back to 1/3-of-window when the window is too narrow
+                # to give that much without crushing the source pane.
                 try:
                     result = subprocess.run(
                         ["tmux", "display-message", "-p", "#{window_width}"],
                         capture_output=True, text=True, check=True,
                     )
                     window_width = int(result.stdout.strip())
-                    pane_width = (window_width - 2) // 3
+                    # Prefer 80 cols if the source pane keeps at least 60.
+                    # Otherwise split evenly. Floor of 40 keeps text legible.
+                    if window_width >= 140:
+                        pane_width = 80
+                    elif window_width >= 100:
+                        pane_width = window_width // 2
+                    else:
+                        pane_width = max(window_width - 2 - 50, 40)
                 except Exception:
-                    pane_width = 60
+                    pane_width = 80
 
-            pane_width = max(pane_width, 20)  # absolute minimum
+            pane_width = max(pane_width, 40)  # absolute minimum for readability
 
         # Watch mode points the new pane at the user's real file so edits
         # propagate; non-watch mode snapshots source into a tempfile.

{termrender-0.7.3 → termrender-1.0.0}/src/termrender/emit.py

@@ -7,12 +7,24 @@ from termrender.renderers import (
     panel, columns, tree, code, text, divider, quote, mermaid, table,
     diff, charts, stat, timeline,
 )
+from termrender.style import visual_ljust
 
 
 def emit_block(block: Block, color: bool) -> list[str]:
     """Render a single block and its children, returning output lines."""
     match block.type:
-        case BlockType.DOCUMENT | BlockType.COL:
+        case BlockType.DOCUMENT:
+            # Insert a blank padded line between top-level siblings so
+            # paragraphs, headings, and blocks don't visually run together.
+            lines: list[str] = []
+            sep = visual_ljust("", block.width or 0)
+            for i, child in enumerate(block.children):
+                if i > 0:
+                    lines.append(sep)
+                lines.extend(emit_block(child, color))
+            return lines
+
+        case BlockType.COL:
             lines: list[str] = []
             for child in block.children:
                 lines.extend(emit_block(child, color))

{termrender-0.7.3 → termrender-1.0.0}/src/termrender/layout.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import subprocess
 
 from termrender.blocks import Block, BlockType
-from termrender.renderers.mermaid import fix_mermaid_encoding
+from termrender.renderers.mermaid import fix_mermaid_encoding, preprocess_mermaid_for_ascii
 from termrender.style import wrap_text, visual_len
 
 
@@ -148,7 +148,7 @@ def resolve_height(block: Block) -> None:
         try:
             result = subprocess.run(
                 ["mermaid-ascii", "-f", "-", "-w", str(block.width or 80), "-y", "1"],
-                input=source,
+                input=preprocess_mermaid_for_ascii(source),
                 capture_output=True,
                 text=True,
                 check=True,
@@ -192,9 +192,15 @@ def resolve_height(block: Block) -> None:
     elif bt == BlockType.TIMELINE:
         entries = block.attrs.get("entries", [])
         title_h = 1 if block.attrs.get("title") else 0
-        # Each entry takes 1 line + 1 connector line between entries (none after last)
         if entries:
-            block.height = title_h + len(entries) * 2 - 1
+            date_w = max(visual_len(e["date"]) for e in entries)
+            event_w = max((block.width or 60) - date_w - 4, 5)
+            total = 0
+            for entry in entries:
+                wrapped = wrap_text(entry["event"], event_w) or [""]
+                total += len(wrapped)
+            total += len(entries) - 1  # connector between entries
+            block.height = title_h + total
         else:
             block.height = max(title_h, 1)
 

{termrender-0.7.3 → termrender-1.0.0}/src/termrender/parser.py

@@ -69,15 +69,13 @@ _DIRECTIVE_TO_BLOCK: dict[str, BlockType] = {
     "gauge": BlockType.GAUGE,
     "stat": BlockType.STAT,
     "timeline": BlockType.TIMELINE,
+    "mermaid": BlockType.MERMAID,
     "tasklist": BlockType.LIST,  # alias: forces tasklist styling on the inner list
 }
 
 _SELF_CLOSING_DIRECTIVES = frozenset({"divider", "progress", "gauge"})
 
-# MyST backtick fence directive: ```{name} optional-argument
-_BACKTICK_DIRECTIVE_RE = re.compile(r"^\{(\w[\w-]*)\}(.*)")
-
-# MyST option line: :key: value — intentionally requires a value after the key
+# Option line: :key: value — intentionally requires a value after the key
 # (the \s+(.+) part). Flag-style options like :nosandbox: (no value) won't match
 # and will be treated as body content.
 _OPTION_LINE_RE = re.compile(r"^:(\w[\w-]*):\s+(.+)$")
@@ -134,7 +132,10 @@ def _convert_inline(nodes: list[dict]) -> list[InlineSpan]:
         elif ntype == "softbreak":
             spans.append(InlineSpan(text=" "))
         elif ntype == "linebreak":
-            spans.append(InlineSpan(text="\n"))
+            # Two \n so wrap_text emits a blank line between the two sides
+            # of the hard break, giving more vertical breathing room than a
+            # soft wrap. See tests/test_linebreak.py.
+            spans.append(InlineSpan(text="\n\n"))
         else:
             # Fallback: try raw text
             if "raw" in node:
@@ -245,7 +246,7 @@ def _expand_inline_roles(spans: list[InlineSpan]) -> list[InlineSpan]:
 
 
 def _strip_options(body: str) -> tuple[dict[str, str], str]:
-    """Strip MyST option lines from the start of a directive body.
+    """Strip option lines from the start of a directive body.
 
     Option lines have the form `:key: value` and appear at the start of the body.
     Blank lines between option lines are allowed. Scanning stops at the first
@@ -302,33 +303,10 @@ def _convert_ast(nodes: list[dict], _depth: int = 0) -> list[Block]:
         elif ntype == "block_code":
             raw = node.get("raw", "")
             info = node.get("attrs", {}).get("info", "")
-            # MyST backtick fence directive: ```{name} optional-arg
-            m_directive = _BACKTICK_DIRECTIVE_RE.match(info) if info else None
-            if m_directive:
-                dir_name = m_directive.group(1)
-                arg_text = m_directive.group(2).strip()
-                if dir_name == "mermaid":
-                    options, body = _strip_options(raw)
-                    attrs = dict(options)
-                    if arg_text:
-                        attrs["argument"] = arg_text
-                    attrs["source"] = body
-                    blocks.append(Block(type=BlockType.MERMAID, attrs=attrs))
-                else:
-                    attrs: dict[str, Any] = {}
-                    if arg_text:
-                        attrs["argument"] = arg_text
-                    blocks.append(_directive_to_block(dir_name, attrs, raw, _depth=_depth))
-            elif info == "mermaid":
-                blocks.append(Block(
-                    type=BlockType.MERMAID,
-                    attrs={"source": raw},
-                ))
-            else:
-                blocks.append(Block(
-                    type=BlockType.CODE,
-                    attrs={"lang": info, "source": raw},
-                ))
+            blocks.append(Block(
+                type=BlockType.CODE,
+                attrs={"lang": info, "source": raw},
+            ))
 
         elif ntype == "list":
             ordered = node.get("attrs", {}).get("ordered", False)
@@ -610,8 +588,8 @@ def _directive_to_block(name: str, attrs: dict[str, Any], body: str, _depth: int
 
     block_type = _DIRECTIVE_TO_BLOCK.get(name, BlockType.PANEL)
 
-    # Tree, Code, Diff: store raw body, don't parse as markdown
-    if block_type in (BlockType.TREE, BlockType.CODE, BlockType.DIFF):
+    # Tree, Code, Diff, Mermaid: store raw body, don't parse as markdown
+    if block_type in (BlockType.TREE, BlockType.CODE, BlockType.DIFF, BlockType.MERMAID):
         attrs["source"] = body
         return Block(type=block_type, attrs=attrs)