termaid 0.1.2__tar.gz → 0.2.0__tar.gz

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

@@ -1,8 +1,15 @@
 # Changelog
 
-## 0.1.2 (2026-03-04)
+## 0.2.0 (2026-03-20)
+
+- Add pie chart support (`pie` syntax, rendered as horizontal bar charts)
+- Add treemap support (`treemap-beta` syntax with nested sections and proportional sizing)
+- 9 diagram types now supported
+
+## 0.1.3 (2026-03-04)
 
 - Add `--tui` flag to CLI for interactive TUI viewer
+- Update demo GIF with pipe and TUI examples
 
 ## 0.1.1 (2026-03-04)
 

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: termaid
-Version: 0.1.2
-Summary: Render Mermaid diagram syntax as beautiful Unicode art in the terminal
+Version: 0.2.0
+Summary: Render Mermaid diagrams in your terminal or Python app
 License-Expression: MIT
 License-File: LICENSE
 Keywords: ascii,diagram,flowchart,mermaid,terminal,unicode
@@ -22,21 +22,21 @@ Provides-Extra: rich
 Requires-Dist: rich>=13.0; extra == 'rich'
 Provides-Extra: textual
 Requires-Dist: textual>=0.40; extra == 'textual'
+Provides-Extra: tui
+Requires-Dist: textual>=0.40; extra == 'tui'
 Description-Content-Type: text/markdown
 
-# termaid
+<h1 align="center">termaid</h1>
 
-Terminal-native Mermaid rendering for Python.
+<p align="center">Render Mermaid diagrams in your terminal or Python app.</p>
 
 <p align="center">
   <img src="demo/termaid-demo.gif" alt="termaid demo" width="800">
 </p>
 
-Render [Mermaid](https://mermaid.js.org/) diagrams as Unicode art directly in your terminal. Pure Python, zero dependencies.
-
 ## Features
 
-- **7 diagram types:** flowcharts, sequence, class, ER, state, block, and git graphs
+- **9 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, and treemaps
 - **Zero dependencies:** pure Python, nothing to install beyond the package itself
 - **Rich and Textual integration:** colored output and TUI widgets with optional extras
 - **6 color themes:** default, terra, neon, mono, amber, phosphor
@@ -53,6 +53,12 @@ Mermaid is great for documentation, but rendering it usually means spinning up a
 pip install termaid
 ```
 
+Or try it without installing:
+
+```bash
+uvx termaid diagram.mmd
+```
+
 ## Quick start
 
 ### CLI
@@ -350,10 +356,55 @@ gitGraph
 
 **Config:** `%%{init: {"gitGraph": {"mainBranchName": "master"}}}%%`
 
+### Pie charts
+
+Yes, the syntax says `pie`. No, we don't draw a circle. I know. Have you ever tried to read a pie chart made of `█` and `▓`? Exactly. We render them as horizontal bar charts instead.
+
+```mermaid
+pie title Pets adopted by volunteers
+    "Dogs" : 386
+    "Cats" : 85
+    "Rats" : 15
+```
+
+```
+  Dogs┃████████████████████████████████  79.4%
+  Cats┃▓▓▓▓▓▓▓  17.5%
+  Rats┃░   3.1%
+```
+
+**Features:** `title`, `showData` (display raw values), `%%` comments
+
+### Treemaps
+
+```mermaid
+treemap-beta
+    "Frontend"
+        "React": 40
+        "CSS": 15
+    "Backend"
+        "API": 35
+        "Auth": 10
+```
+
+```
+┌┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┐ ┌┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┐
+┆             Frontend              ┆ ┆          Backend           ┆
+┆┌───────────────────────┐ ┌───────┐┆ ┆┌───────────────────┐ ┌────┐┆
+┆│         React         │ │  CSS  │┆ ┆│        API        │ │Auth│┆
+┆│          40           │ │  15   │┆ ┆│        35         │ │ 10 │┆
+┆│                       │ │       │┆ ┆│                   │ │    │┆
+┆└───────────────────────┘ └───────┘┆ ┆└───────────────────┘ └────┘┆
+└┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┘ └┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┘
+```
+
+**Features:** nested sections via indentation, `"label": value` syntax, proportional sizing, `%%` comments
+
 ## CLI options
 
 | Flag | Description |
 |------|-------------|
+| `--tui` | Interactive TUI viewer (requires `pip install termaid[tui]`) |
 | `--ascii` | ASCII-only output (no Unicode box-drawing) |
 | `--theme NAME` | Color theme: `default`, `terra`, `neon`, `mono`, `amber`, `phosphor` (requires `pip install termaid[rich]`) |
 | `--padding-x N` | Horizontal padding inside boxes (default: 4) |

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

@@ -1,16 +1,14 @@
-# termaid
+<h1 align="center">termaid</h1>
 
-Terminal-native Mermaid rendering for Python.
+<p align="center">Render Mermaid diagrams in your terminal or Python app.</p>
 
 <p align="center">
   <img src="demo/termaid-demo.gif" alt="termaid demo" width="800">
 </p>
 
-Render [Mermaid](https://mermaid.js.org/) diagrams as Unicode art directly in your terminal. Pure Python, zero dependencies.
-
 ## Features
 
-- **7 diagram types:** flowcharts, sequence, class, ER, state, block, and git graphs
+- **9 diagram types:** flowcharts, sequence, class, ER, state, block, git graphs, pie charts, and treemaps
 - **Zero dependencies:** pure Python, nothing to install beyond the package itself
 - **Rich and Textual integration:** colored output and TUI widgets with optional extras
 - **6 color themes:** default, terra, neon, mono, amber, phosphor
@@ -27,6 +25,12 @@ Mermaid is great for documentation, but rendering it usually means spinning up a
 pip install termaid
 ```
 
+Or try it without installing:
+
+```bash
+uvx termaid diagram.mmd
+```
+
 ## Quick start
 
 ### CLI
@@ -324,10 +328,55 @@ gitGraph
 
 **Config:** `%%{init: {"gitGraph": {"mainBranchName": "master"}}}%%`
 
+### Pie charts
+
+Yes, the syntax says `pie`. No, we don't draw a circle. I know. Have you ever tried to read a pie chart made of `█` and `▓`? Exactly. We render them as horizontal bar charts instead.
+
+```mermaid
+pie title Pets adopted by volunteers
+    "Dogs" : 386
+    "Cats" : 85
+    "Rats" : 15
+```
+
+```
+  Dogs┃████████████████████████████████  79.4%
+  Cats┃▓▓▓▓▓▓▓  17.5%
+  Rats┃░   3.1%
+```
+
+**Features:** `title`, `showData` (display raw values), `%%` comments
+
+### Treemaps
+
+```mermaid
+treemap-beta
+    "Frontend"
+        "React": 40
+        "CSS": 15
+    "Backend"
+        "API": 35
+        "Auth": 10
+```
+
+```
+┌┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┐ ┌┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┐
+┆             Frontend              ┆ ┆          Backend           ┆
+┆┌───────────────────────┐ ┌───────┐┆ ┆┌───────────────────┐ ┌────┐┆
+┆│         React         │ │  CSS  │┆ ┆│        API        │ │Auth│┆
+┆│          40           │ │  15   │┆ ┆│        35         │ │ 10 │┆
+┆│                       │ │       │┆ ┆│                   │ │    │┆
+┆└───────────────────────┘ └───────┘┆ ┆└───────────────────┘ └────┘┆
+└┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┘ └┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┘
+```
+
+**Features:** nested sections via indentation, `"label": value` syntax, proportional sizing, `%%` comments
+
 ## CLI options
 
 | Flag | Description |
 |------|-------------|
+| `--tui` | Interactive TUI viewer (requires `pip install termaid[tui]`) |
 | `--ascii` | ASCII-only output (no Unicode box-drawing) |
 | `--theme NAME` | Color theme: `default`, `terra`, `neon`, `mono`, `amber`, `phosphor` (requires `pip install termaid[rich]`) |
 | `--padding-x N` | Horizontal padding inside boxes (default: 4) |

{termaid-0.1.2 → termaid-0.2.0}/demo/demo.tape

@@ -16,9 +16,15 @@ Env "PS1" "$ "
 Env "VIRTUAL_ENV" ""
 
 Hide
+Type "source .venv/bin/activate"
+Enter
+Sleep 500ms
 Type "cd demo"
 Enter
 Sleep 500ms
+Type "export PS1='$ '"
+Enter
+Sleep 500ms
 Ctrl+L
 Show
 
@@ -39,6 +45,24 @@ Sleep 4s
 
 # 4. One-liner hook — pipe-friendly with branching
 Ctrl+L
+Set TypingSpeed 0
+Type "# Pipe-friendly: works with echo, cat, curl..."
+Enter
+Set TypingSpeed 32ms
+Sleep 1s
 Type "echo 'graph LR; A[Request] --> B{Valid?}; B -->|Yes| C[Process]; B -->|No| D[Error]' | termaid --theme default"
 Enter
+Sleep 3s
+
+# 5. TUI mode — interactive viewer
+Ctrl+L
+Set TypingSpeed 0
+Type "# Interactive TUI mode"
+Enter
+Set TypingSpeed 32ms
+Sleep 1s
+Type "termaid erdiagram.mmd --tui"
+Enter
 Sleep 4s
+Type "q"
+Sleep 1s

termaid-0.2.0/demo/erdiagram.mmd

@@ -0,0 +1,19 @@
+erDiagram
+    USER ||--o{ ORDER : places
+    USER {
+        int id PK
+        string name
+        string email
+    }
+    ORDER ||--|{ LINE_ITEM : contains
+    ORDER {
+        int id PK
+        date created
+        string status
+    }
+    PRODUCT ||--o{ LINE_ITEM : "ordered in"
+    PRODUCT {
+        int id PK
+        string name
+        float price
+    }

{termaid-0.1.2 → termaid-0.2.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "termaid"
-version = "0.1.2"
-description = "Render Mermaid diagram syntax as beautiful Unicode art in the terminal"
+version = "0.2.0"
+description = "Render Mermaid diagrams in your terminal or Python app"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.11"
@@ -25,6 +25,7 @@ classifiers = [
 [project.optional-dependencies]
 rich = ["rich>=13.0"]
 textual = ["textual>=0.40"]
+tui = ["textual>=0.40"]
 dev = [
     "pytest>=7.0",
     "pytest-snapshot",

{termaid-0.1.2 → termaid-0.2.0}/src/termaid/__init__.py

@@ -90,6 +90,18 @@ def render(
             diagram = parse_git_graph(text)
             return render_git_graph(diagram, use_ascii=use_ascii).to_string()
 
+        if text.startswith("pie"):
+            from .parser.piechart import parse_pie_chart
+            from .renderer.piechart import render_pie_chart
+            diagram = parse_pie_chart(text)
+            return render_pie_chart(diagram, use_ascii=use_ascii).to_string()
+
+        if text.startswith("treemap"):
+            from .parser.treemap import parse_treemap
+            from .renderer.treemap import render_treemap
+            diagram = parse_treemap(text)
+            return render_treemap(diagram, use_ascii=use_ascii).to_string()
+
         graph = parse(text)
         from .output.text import render_text
         return render_text(graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y, rounded_edges=rounded_edges)
@@ -162,6 +174,22 @@ def render_rich(
             canvas = render_git_graph(diagram, use_ascii=use_ascii)
             return render_sequence_rich(canvas, theme=theme)
 
+        if text.startswith("pie"):
+            from .parser.piechart import parse_pie_chart
+            from .renderer.piechart import render_pie_chart
+            from .output.rich import render_sequence_rich
+            diagram = parse_pie_chart(text)
+            canvas = render_pie_chart(diagram, use_ascii=use_ascii)
+            return render_sequence_rich(canvas, theme=theme)
+
+        if text.startswith("treemap"):
+            from .parser.treemap import parse_treemap
+            from .renderer.treemap import render_treemap
+            from .output.rich import render_sequence_rich
+            diagram = parse_treemap(text)
+            canvas = render_treemap(diagram, use_ascii=use_ascii)
+            return render_sequence_rich(canvas, theme=theme)
+
         graph = parse(text)
         from .output.rich import render_rich as _render_rich
         return _render_rich(graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y, rounded_edges=rounded_edges, theme=theme)

{termaid-0.1.2 → termaid-0.2.0}/src/termaid/cli.py

@@ -53,7 +53,7 @@ def main(argv: list[str] | None = None) -> int:
     parser.add_argument(
         "--version",
         action="version",
-        version="%(prog)s 0.1.2",
+        version="%(prog)s 0.1.3",
     )
 
     args = parser.parse_args(argv)

termaid-0.2.0/src/termaid/model/piechart.py

@@ -0,0 +1,18 @@
+"""Data model for pie chart diagrams (rendered as bar charts)."""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class PieSlice:
+    label: str
+    value: float
+
+
+@dataclass
+class PieChart:
+    title: str = ""
+    show_data: bool = False
+    slices: list[PieSlice] = field(default_factory=list)
+    warnings: list[str] = field(default_factory=list)

termaid-0.2.0/src/termaid/model/treemap.py

@@ -0,0 +1,28 @@
+"""Data model for treemap diagrams."""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class TreemapNode:
+    label: str
+    value: float = 0
+    children: list[TreemapNode] = field(default_factory=list)
+
+    @property
+    def total_value(self) -> float:
+        """Total value: own value for leaves, sum of children for sections."""
+        if self.children:
+            return sum(c.total_value for c in self.children)
+        return self.value
+
+
+@dataclass
+class Treemap:
+    roots: list[TreemapNode] = field(default_factory=list)
+    warnings: list[str] = field(default_factory=list)
+
+    @property
+    def total_value(self) -> float:
+        return sum(r.total_value for r in self.roots)

termaid-0.2.0/src/termaid/parser/piechart.py

@@ -0,0 +1,63 @@
+"""Parser for Mermaid pie chart diagrams.
+
+Syntax:
+    pie [showData]
+        [title <text>]
+        "<label>" : <value>
+        ...
+"""
+from __future__ import annotations
+
+import re
+
+from ..model.piechart import PieChart, PieSlice
+
+_SLICE_RE = re.compile(r'^\s*"([^"]+)"\s*:\s*([0-9]+(?:\.[0-9]*)?)$')
+
+
+def parse_pie_chart(text: str) -> PieChart:
+    """Parse a mermaid pie chart definition."""
+    lines = text.strip().splitlines()
+    chart = PieChart()
+
+    if not lines:
+        return chart
+
+    # Parse header line: pie [showData]
+    header = lines[0].strip()
+    if "showData" in header:
+        chart.show_data = True
+
+    for line in lines[1:]:
+        stripped = line.strip()
+        if not stripped:
+            continue
+
+        # Strip comments
+        comment_idx = stripped.find("%%")
+        if comment_idx >= 0:
+            stripped = stripped[:comment_idx].strip()
+            if not stripped:
+                continue
+
+        # Title
+        if stripped.lower().startswith("title "):
+            chart.title = stripped[6:].strip()
+            continue
+
+        # Slice: "Label" : value
+        m = _SLICE_RE.match(stripped)
+        if m:
+            label = m.group(1)
+            value = float(m.group(2))
+            if value <= 0:
+                chart.warnings.append(f"Pie slice value must be positive: {label} = {value}")
+                continue
+            chart.slices.append(PieSlice(label=label, value=value))
+            continue
+
+        # Unrecognized line
+        if stripped:
+            chart.warnings.append(f"Unrecognized line: {stripped}")
+
+    return chart

termaid-0.2.0/src/termaid/parser/treemap.py

@@ -0,0 +1,67 @@
+"""Parser for Mermaid treemap diagrams.
+
+Syntax:
+    treemap-beta
+    "Section 1"
+        "Leaf 1.1": 12
+        "Section 1.2"
+            "Leaf 1.2.1": 12
+    "Section 2"
+        "Leaf 2.1": 20
+"""
+from __future__ import annotations
+
+import re
+
+from ..model.treemap import Treemap, TreemapNode
+
+_NODE_RE = re.compile(r'^(\s*)"([^"]+)"(?:\s*:\s*([0-9]+(?:\.[0-9]*)?))?')
+
+
+def parse_treemap(text: str) -> Treemap:
+    """Parse a mermaid treemap definition."""
+    lines = text.strip().splitlines()
+    treemap = Treemap()
+
+    if not lines:
+        return treemap
+
+    # Skip header line (treemap-beta)
+    body_lines: list[tuple[int, str, float]] = []
+    for line in lines[1:]:
+        # Strip comments
+        comment_idx = line.find("%%")
+        if comment_idx >= 0:
+            line = line[:comment_idx]
+
+        m = _NODE_RE.match(line)
+        if not m:
+            continue
+
+        indent = len(m.group(1))
+        label = m.group(2)
+        value = float(m.group(3)) if m.group(3) else 0
+        body_lines.append((indent, label, value))
+
+    if not body_lines:
+        return treemap
+
+    # Build tree from indentation
+    # Stack: (indent_level, node)
+    stack: list[tuple[int, TreemapNode]] = []
+
+    for indent, label, value in body_lines:
+        node = TreemapNode(label=label, value=value)
+
+        # Pop stack until we find a parent with less indentation
+        while stack and stack[-1][0] >= indent:
+            stack.pop()
+
+        if stack:
+            stack[-1][1].children.append(node)
+        else:
+            treemap.roots.append(node)
+
+        stack.append((indent, node))
+
+    return treemap

termaid-0.2.0/src/termaid/renderer/piechart.py

@@ -0,0 +1,83 @@
+"""Renderer for pie chart diagrams as horizontal bar charts.
+
+Draws per-slice horizontal bars with right-aligned labels,
+percentages, and optional raw values.
+"""
+from __future__ import annotations
+
+from ..model.piechart import PieChart
+from .canvas import Canvas
+from .charset import ASCII, UNICODE, CharSet
+
+_FILL_CHARS = ["█", "▓", "░", "▒", "▞", "▚", "▖", "▗"]
+_FILL_CHARS_ASCII = ["#", "*", "+", "~", ":", ".", "o", "="]
+
+_BAR_WIDTH = 40
+_MARGIN = 2
+
+
+def render_pie_chart(
+    diagram: PieChart,
+    *,
+    use_ascii: bool = False,
+) -> Canvas:
+    """Render a PieChart as a horizontal bar chart on a Canvas."""
+
+    if not diagram.slices:
+        canvas = Canvas(1, 1)
+        return canvas
+
+    total = sum(s.value for s in diagram.slices)
+    fills = _FILL_CHARS_ASCII if use_ascii else _FILL_CHARS
+
+    # Compute label column width
+    max_label_len = max(len(s.label) for s in diagram.slices)
+    label_col_w = max_label_len + _MARGIN
+
+    # Compute suffix (percentage + optional value)
+    suffixes: list[str] = []
+    for s in diagram.slices:
+        pct = s.value / total * 100
+        if diagram.show_data:
+            suffixes.append(f" {pct:5.1f}%  [{s.value:g}]")
+        else:
+            suffixes.append(f" {pct:5.1f}%")
+    max_suffix_len = max(len(sf) for sf in suffixes)
+
+    bar_left = label_col_w
+    canvas_w = bar_left + _BAR_WIDTH + max_suffix_len + _MARGIN
+    title_rows = 2 if diagram.title else 0
+
+    bars_top = _MARGIN + title_rows
+    canvas_h = bars_top + len(diagram.slices) + _MARGIN
+
+    canvas = Canvas(canvas_w, canvas_h)
+
+    # Title
+    if diagram.title:
+        title_col = max(0, (canvas_w - len(diagram.title)) // 2)
+        canvas.put_text(_MARGIN, title_col, diagram.title, style="label")
+
+    # ── Per-slice bars ────────────────────────────────────────────────────
+    for i, s in enumerate(diagram.slices):
+        row = bars_top + i
+        pct = s.value / total * 100
+        fill = fills[i % len(fills)]
+        bar_len = max(1, round(s.value / total * _BAR_WIDTH))
+
+        # Label (right-aligned)
+        label_text = s.label.rjust(max_label_len)
+        canvas.put_text(row, _MARGIN, label_text, style="label")
+
+        # Bar
+        if use_ascii:
+            canvas.put(row, bar_left, "|", merge=False, style="edge")
+        else:
+            canvas.put(row, bar_left, "┃", merge=False, style="edge")
+        for c in range(bar_len):
+            canvas.put(row, bar_left + 1 + c, fill, merge=False, style="node")
+
+        # Suffix
+        canvas.put_text(row, bar_left + 1 + bar_len, suffixes[i], style="label")
+
+    return canvas