termrender 2.0.0__tar.gz → 3.0.0__tar.gz

{termrender-2.0.0 → termrender-3.0.0}/CHANGELOG.md

@@ -1,6 +1,65 @@
 # CHANGELOG
 
 
+## v3.0.0 (2026-05-18)
+
+### Chores
+
+- Re-trigger release publish for v3.0.0
+  ([`467c583`](https://github.com/crouton-labs/termrender/commit/467c58338de217a417530e0bc32ad0a6973012eb))
+
+### Documentation
+
+- **claude-md**: Update CLI invocations to v3 flag form, prune stale notes
+  ([`1276bf8`](https://github.com/crouton-labs/termrender/commit/1276bf86261528a725f8a012e2105b359f085eca))
+
+### Features
+
+- **cli**: Switch input contract to flags + positional + stdin
+  ([`38df421`](https://github.com/crouton-labs/termrender/commit/38df4218af8c26d469a442b87090ad268ae47b0e))
+
+Drops JSON-on-stdin in favor of long-form flags, at most one positional, stdin for the markdown
+  content blob, per cli-design v2. Output (ANSI for render, JSON elsewhere), errors, and exit codes
+  are unchanged.
+
+- doc render / doc check now read source from stdin - doc watch / pane open / pane update take path
+  as positional - pane update gains --pane-id flag - --color is an enum (auto|on|off) replacing the
+  prior bool|null - --watch is presence-only and defaults to false on pane open/update - Internal
+  pane self-pipe rebuilds the new flag-form invocations
+
+
+## v2.1.0 (2026-05-16)
+
+### Documentation
+
+- **claude-md**: Document mermaid-ascii vendoring and correct stale --maxWidth
+  ([`643e25a`](https://github.com/crouton-labs/termrender/commit/643e25a791de1f32591b245dee064f290221cfc2))
+
+Note _mermaid_bin resolution, the pinned master binary, the no-width-flag reality, and the back-edge
+  panic in renderers/CLAUDE.md.
+
+- **claude-md**: Note QUOTE +1 height only applies to author/by attrs
+  ([`3184d43`](https://github.com/crouton-labs/termrender/commit/3184d43e7293af735b82d559bc3253d7542cbf85))
+
+### Features
+
+- **mermaid**: Vendor engine from upstream master, fix broken -w invocation
+  ([`d801de5`](https://github.com/crouton-labs/termrender/commit/d801de5bb22ba5205fe52ef65e80eda96590be93))
+
+mermaid-ascii has no -w/width flag and never has; layout.py and mermaid.py passed `-w <width>`, so
+  every diagram exited non-zero and degraded to raw source text on the 1.2.0 wheel. Drop -w (call is
+  now `-f - -y 1`).
+
+Resolve the binary via new _mermaid_bin.mermaid_ascii_bin(): prefer vendored
+  _bin/mermaid-ascii-<os>-<arch> (built from pinned upstream master 6fffb8e via
+  scripts/build-mermaid-ascii.sh), else fall back to `mermaid-ascii` on PATH (PyPI wheel, capped at
+  1.2.0). pyproject ships the binary via hatch artifacts and bumps the fallback dep to >=1.2.
+
+Caveats: only darwin-arm64 is vendored (other platforms fall back to the older PyPI engine); a
+  labeled back-edge in graph LR panics the binary on both 1.2.0 and master and degrades to source.
+  mermaid-ascii has no width control, so wide diagrams overflow (renderer pads, never truncates).
+
+
 ## v2.0.0 (2026-05-16)
 
 ### Continuous Integration

{termrender-2.0.0 → termrender-3.0.0}/CLAUDE.md

@@ -4,18 +4,16 @@
 ```bash
 pip install -e .
 pytest tests/
-python -m termrender <file.md>
+cat file.md | termrender doc render          # render markdown
+cat file.md | termrender doc check           # validate syntax
+termrender doc watch /path/to/file.md        # live-render
 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

{termrender-2.0.0 → termrender-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termrender
-Version: 2.0.0
+Version: 3.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
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Terminals
 Classifier: Topic :: Text Processing :: Markup :: Markdown
 Requires-Python: >=3.10
-Requires-Dist: mermaid-ascii>=1.0
+Requires-Dist: mermaid-ascii>=1.2
 Requires-Dist: mistune>=3.0
 Requires-Dist: pygments>=2.0
 Description-Content-Type: text/markdown
@@ -170,14 +170,29 @@ Python 3.10+. Three dependencies: [mistune](https://github.com/lepture/mistune)
 ### CLI
 
 ```bash
-termrender doc.md                    # render a file
-termrender doc.md --width 100        # fixed width
-termrender doc.md --no-color         # strip ANSI codes
-cat doc.md | termrender              # from stdin
-echo '# Hello' | termrender          # inline
+cat doc.md | termrender doc render                        # render a file
+cat doc.md | termrender doc render --width 100            # fixed width
+cat doc.md | termrender doc render --color off            # strip ANSI codes
+cat doc.md | termrender doc render --color on --cjk       # force color + CJK mode
+echo '# Hello' | termrender doc render                    # inline
+
+cat doc.md | termrender doc check                         # validate syntax
+termrender doc watch /path/to/doc.md                      # live-render (interactive)
+termrender doc watch --color on /path/to/doc.md           # live-render with color
 ```
 
-Reads from a file or stdin. Auto-detects terminal width unless you specify `--width`. Respects `NO_COLOR`.
+`doc render` and `doc check` read markdown from stdin. `doc watch` takes the file path as a positional argument. Auto-detects terminal width unless you specify `--width`. Respects `NO_COLOR` with `--color auto` (the default).
+
+For tmux pane management:
+
+```bash
+termrender pane open /path/to/doc.md                      # spawn a side pane
+termrender pane open --watch /path/to/doc.md              # spawn with live-update
+termrender pane open --width 80 --window new /path/to/doc.md
+
+termrender pane update /path/to/new.md --pane-id %23      # update existing pane
+termrender pane update --watch /path/to/doc.md --pane-id %23
+```
 
 ### Python
 

{termrender-2.0.0 → termrender-3.0.0}/README.md

@@ -142,14 +142,29 @@ Python 3.10+. Three dependencies: [mistune](https://github.com/lepture/mistune)
 ### CLI
 
 ```bash
-termrender doc.md                    # render a file
-termrender doc.md --width 100        # fixed width
-termrender doc.md --no-color         # strip ANSI codes
-cat doc.md | termrender              # from stdin
-echo '# Hello' | termrender          # inline
+cat doc.md | termrender doc render                        # render a file
+cat doc.md | termrender doc render --width 100            # fixed width
+cat doc.md | termrender doc render --color off            # strip ANSI codes
+cat doc.md | termrender doc render --color on --cjk       # force color + CJK mode
+echo '# Hello' | termrender doc render                    # inline
+
+cat doc.md | termrender doc check                         # validate syntax
+termrender doc watch /path/to/doc.md                      # live-render (interactive)
+termrender doc watch --color on /path/to/doc.md           # live-render with color
 ```
 
-Reads from a file or stdin. Auto-detects terminal width unless you specify `--width`. Respects `NO_COLOR`.
+`doc render` and `doc check` read markdown from stdin. `doc watch` takes the file path as a positional argument. Auto-detects terminal width unless you specify `--width`. Respects `NO_COLOR` with `--color auto` (the default).
+
+For tmux pane management:
+
+```bash
+termrender pane open /path/to/doc.md                      # spawn a side pane
+termrender pane open --watch /path/to/doc.md              # spawn with live-update
+termrender pane open --width 80 --window new /path/to/doc.md
+
+termrender pane update /path/to/new.md --pane-id %23      # update existing pane
+termrender pane update --watch /path/to/doc.md --pane-id %23
+```
 
 ### Python
 

{termrender-2.0.0 → termrender-3.0.0}/pyproject.toml

@@ -28,7 +28,7 @@ classifiers = [
 ]
 dependencies = [
     "mistune>=3.0",
-    "mermaid-ascii>=1.0",
+    "mermaid-ascii>=1.2",
     "pygments>=2.0",
 ]
 
@@ -45,6 +45,11 @@ source = "vcs"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/termrender"]
+# Ship the vendored mermaid-ascii binary (built from pinned upstream master;
+# see scripts/build-mermaid-ascii.sh). It lives inside the package dir so the
+# default file selection includes it; artifacts ensures it survives even if
+# VCS-ignored, and hatchling preserves its 0o755 exec bit.
+artifacts = ["src/termrender/_bin/*"]
 
 [tool.semantic_release]
 version_toml = []

termrender-3.0.0/scripts/build-mermaid-ascii.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Build the vendored mermaid-ascii binary from pinned upstream master.
+#
+# Usage: scripts/build-mermaid-ascii.sh
+#
+# Produces src/termrender/_bin/mermaid-ascii-<os>-<arch> for the *host*
+# platform. Run on each target platform (or with GOOS/GOARCH set) to refresh
+# the vendored binaries. Requires a Go toolchain (>=1.21).
+#
+# Why vendored: the PyPI `mermaid-ascii` wheel only ships up to 1.2.0, which
+# lacks the master-only flowchart fixes (multiline node labels, duplicate /
+# bidirectional edge-label separation, subgraph titles, wide-rune label
+# widths). termrender prefers this binary and falls back to the PyPI wheel's
+# `mermaid-ascii` on PATH for platforms not vendored here.
+set -euo pipefail
+
+# Pinned upstream commit (github.com/AlexanderGrooff/mermaid-ascii master).
+PIN="6fffb8e2714acab2c4cb41c78894fabbc62cee56"
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+workdir="$(mktemp -d)"
+trap 'rm -rf "$workdir"' EXIT
+
+git clone https://github.com/AlexanderGrooff/mermaid-ascii.git "$workdir/src"
+git -C "$workdir/src" checkout --quiet "$PIN"
+
+os="$(go env GOOS)"
+arch="$(go env GOARCH)"
+out="$repo_root/src/termrender/_bin/mermaid-ascii-${os}-${arch}"
+
+mkdir -p "$(dirname "$out")"
+( cd "$workdir/src" && go build -trimpath -o "$out" . )
+chmod 755 "$out"
+
+echo "Built $out"
+"$out" --help >/dev/null && echo "Smoke test OK (pin ${PIN:0:7})"

termrender-3.0.0/src/termrender/CLAUDE.md

@@ -0,0 +1 @@
+- **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.