termrender 2.1.0__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,33 @@
 # 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

{termrender-2.1.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.1.0 → termrender-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termrender
-Version: 2.1.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
@@ -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.1.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