termaid 0.2.1__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.1 → termaid-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termaid
-Version: 0.2.1
+Version: 0.3.0
 Summary: Render Mermaid diagrams in your terminal or Python app
 License-Expression: MIT
 License-File: LICENSE
@@ -38,8 +38,9 @@ Description-Content-Type: text/markdown
 
 ## 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
@@ -402,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 |
@@ -412,7 +437,11 @@ treemap-beta
 | `--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
 
@@ -458,9 +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.
-- **Wide LR diagrams.** Long horizontal chains can exceed terminal width. Use `--gap 1` or `--padding-x 0` for compact output, or pipe through `less -S` for horizontal scrolling.
+- **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.1 → termaid-0.3.0}/README.md

@@ -10,8 +10,9 @@
 
 ## 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
@@ -374,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 |
@@ -384,7 +409,11 @@ treemap-beta
 | `--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
 
@@ -430,9 +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.
-- **Wide LR diagrams.** Long horizontal chains can exceed terminal width. Use `--gap 1` or `--padding-x 0` for compact output, or pipe through `less -S` for horizontal scrolling.
+- **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