termaid 0.2.0__tar.gz → 0.3.0__tar.gz

termaid-0.3.0/.gitignore

@@ -0,0 +1,20 @@
+.DS_Store
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+# Scratch diagram files in root
+/*.mmd
+
+# Demo source files (tape scripts, scratch mmd) — keep only the gif
+demo/*.tape
+demo/*.mmd
+demo/.DS_Store
+
+# Other scratch files
+.coverage
+*.txt
+screenshot.png

{termaid-0.2.0 → termaid-0.3.0}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.1 (2026-03-25)
+
+- Add `--gap` CLI flag and `gap` parameter for compact diagram spacing
+- Document wide LR diagram workarounds in README
+
 ## 0.2.0 (2026-03-20)
 
 - Add pie chart support (`pie` syntax, rendered as horizontal bar charts)

{termaid-0.2.0 → termaid-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termaid
-Version: 0.2.0
+Version: 0.3.0
 Summary: Render Mermaid diagrams in your terminal or Python app
 License-Expression: MIT
 License-File: LICENSE
@@ -34,10 +34,13 @@ Description-Content-Type: text/markdown
   <img src="demo/termaid-demo.gif" alt="termaid demo" width="800">
 </p>
 
+**[Try it online at termaid.com](https://termaid.com)**
+
 ## Features
 
-- **9 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, and treemaps
+- **10 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, treemaps, and mindmaps
 - **Zero dependencies:** pure Python, nothing to install beyond the package itself
+- **Terminal-aware:** auto-fits diagrams to terminal width with progressive compaction
 - **Rich and Textual integration:** colored output and TUI widgets with optional extras
 - **6 color themes:** default, terra, neon, mono, amber, phosphor
 - **ASCII fallback:** works on any terminal, even the most basic ones
@@ -400,6 +403,30 @@ treemap-beta
 
 **Features:** nested sections via indentation, `"label": value` syntax, proportional sizing, `%%` comments
 
+### Mindmaps
+
+```mermaid
+mindmap
+  Project
+    Design
+      Wireframes
+      Mockups
+    Development
+      Frontend
+      Backend
+    Testing
+```
+
+```
+          ╭─ Design ──╭─ Wireframes
+          │           ╰─ Mockups
+Project ──├─ Development ──╭─ Frontend
+          │                ╰─ Backend
+          ╰─ Testing
+```
+
+**Features:** indentation-based nesting, automatic overflow to the left when many children, rounded/sharp/ASCII branch characters, Mermaid shape markers stripped (`(round)`, `[square]`, `{{hexagon}}`, `)cloud(`)
+
 ## CLI options
 
 | Flag | Description |
@@ -409,7 +436,12 @@ treemap-beta
 | `--theme NAME` | Color theme: `default`, `terra`, `neon`, `mono`, `amber`, `phosphor` (requires `pip install termaid[rich]`) |
 | `--padding-x N` | Horizontal padding inside boxes (default: 4) |
 | `--padding-y N` | Vertical padding inside boxes (default: 2) |
+| `--gap N` | Space between nodes (default: 4). Use `1` or `2` for compact diagrams |
+| `--width N` | Max output width. Re-renders with smaller gap/padding if exceeded |
+| `--no-auto-fit` | Disable automatic compaction when diagram exceeds terminal width |
 | `--sharp-edges` | Sharp corners on edge turns instead of rounded |
+| `-o FILE` | Write output to file instead of stdout |
+| `--show-ids` | Show node IDs alongside labels for debugging (e.g. `myId: My Label`) |
 
 ## Python API
 
@@ -455,8 +487,13 @@ pip install termaid[textual]   # Textual TUI widget
 
 ## Limitations
 
-- **Layout engine is approximate.** Node positioning uses a grid-based barycenter heuristic. Graphs with many cross-layer edges may still produce crossings.
-- **Manhattan-only edge routing.** Edges use A* pathfinding on a grid. Very dense graphs may have overlapping edges.
+- **Layout engine is approximate.** Node positioning uses a grid-based barycenter heuristic. Very dense graphs may still produce some edge crossings.
+- **Manhattan-only edge routing.** Edges use A* pathfinding on a grid. The engine auto-expands gaps for crossing edges and biases toward flow-aligned routes.
+- **Wide diagrams.** The CLI auto-compacts when the diagram exceeds terminal width. For very wide LR chains, use `--width N`, `--gap 1`, or pipe through `less -S`.
+
+## Gallery
+
+See [docs/gallery.md](docs/gallery.md) for rendered examples of all 78 supported diagram fixtures.
 
 ## Acknowledgements
 

{termaid-0.2.0 → termaid-0.3.0}/README.md

@@ -6,10 +6,13 @@
   <img src="demo/termaid-demo.gif" alt="termaid demo" width="800">
 </p>
 
+**[Try it online at termaid.com](https://termaid.com)**
+
 ## Features
 
-- **9 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, and treemaps
+- **10 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, treemaps, and mindmaps
 - **Zero dependencies:** pure Python, nothing to install beyond the package itself
+- **Terminal-aware:** auto-fits diagrams to terminal width with progressive compaction
 - **Rich and Textual integration:** colored output and TUI widgets with optional extras
 - **6 color themes:** default, terra, neon, mono, amber, phosphor
 - **ASCII fallback:** works on any terminal, even the most basic ones
@@ -372,6 +375,30 @@ treemap-beta
 
 **Features:** nested sections via indentation, `"label": value` syntax, proportional sizing, `%%` comments
 
+### Mindmaps
+
+```mermaid
+mindmap
+  Project
+    Design
+      Wireframes
+      Mockups
+    Development
+      Frontend
+      Backend
+    Testing
+```
+
+```
+          ╭─ Design ──╭─ Wireframes
+          │           ╰─ Mockups
+Project ──├─ Development ──╭─ Frontend
+          │                ╰─ Backend
+          ╰─ Testing
+```
+
+**Features:** indentation-based nesting, automatic overflow to the left when many children, rounded/sharp/ASCII branch characters, Mermaid shape markers stripped (`(round)`, `[square]`, `{{hexagon}}`, `)cloud(`)
+
 ## CLI options
 
 | Flag | Description |
@@ -381,7 +408,12 @@ treemap-beta
 | `--theme NAME` | Color theme: `default`, `terra`, `neon`, `mono`, `amber`, `phosphor` (requires `pip install termaid[rich]`) |
 | `--padding-x N` | Horizontal padding inside boxes (default: 4) |
 | `--padding-y N` | Vertical padding inside boxes (default: 2) |
+| `--gap N` | Space between nodes (default: 4). Use `1` or `2` for compact diagrams |
+| `--width N` | Max output width. Re-renders with smaller gap/padding if exceeded |
+| `--no-auto-fit` | Disable automatic compaction when diagram exceeds terminal width |
 | `--sharp-edges` | Sharp corners on edge turns instead of rounded |
+| `-o FILE` | Write output to file instead of stdout |
+| `--show-ids` | Show node IDs alongside labels for debugging (e.g. `myId: My Label`) |
 
 ## Python API
 
@@ -427,8 +459,13 @@ pip install termaid[textual]   # Textual TUI widget
 
 ## Limitations
 
-- **Layout engine is approximate.** Node positioning uses a grid-based barycenter heuristic. Graphs with many cross-layer edges may still produce crossings.
-- **Manhattan-only edge routing.** Edges use A* pathfinding on a grid. Very dense graphs may have overlapping edges.
+- **Layout engine is approximate.** Node positioning uses a grid-based barycenter heuristic. Very dense graphs may still produce some edge crossings.
+- **Manhattan-only edge routing.** Edges use A* pathfinding on a grid. The engine auto-expands gaps for crossing edges and biases toward flow-aligned routes.
+- **Wide diagrams.** The CLI auto-compacts when the diagram exceeds terminal width. For very wide LR chains, use `--width N`, `--gap 1`, or pipe through `less -S`.
+
+## Gallery
+
+See [docs/gallery.md](docs/gallery.md) for rendered examples of all 78 supported diagram fixtures.
 
 ## Acknowledgements