termaid 0.2.0__tar.gz → 0.2.1__tar.gz

{termaid-0.2.0 → termaid-0.2.1}/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.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: termaid
-Version: 0.2.0
+Version: 0.2.1
 Summary: Render Mermaid diagrams in your terminal or Python app
 License-Expression: MIT
 License-File: LICENSE
@@ -34,6 +34,8 @@ 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
@@ -409,6 +411,7 @@ 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 |
 | `--sharp-edges` | Sharp corners on edge turns instead of rounded |
 
 ## Python API
@@ -457,6 +460,7 @@ pip install termaid[textual]   # Textual TUI widget
 
 - **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.
 
 ## Acknowledgements
 

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

@@ -6,6 +6,8 @@
   <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
@@ -381,6 +383,7 @@ 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 |
 | `--sharp-edges` | Sharp corners on edge turns instead of rounded |
 
 ## Python API
@@ -429,6 +432,7 @@ pip install termaid[textual]   # Textual TUI widget
 
 - **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.
 
 ## Acknowledgements
 

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "termaid"
-version = "0.2.0"
+version = "0.2.1"
 description = "Render Mermaid diagrams in your terminal or Python app"
 readme = "README.md"
 license = "MIT"

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

@@ -42,6 +42,7 @@ def render(
     padding_x: int = 4,
     padding_y: int = 2,
     rounded_edges: bool = True,
+    gap: int = 4,
 ) -> str:
     """Render mermaid syntax as Unicode (or ASCII) art.
 
@@ -50,6 +51,7 @@ def render(
         use_ascii: Use ASCII characters instead of Unicode box-drawing
         padding_x: Horizontal padding inside node boxes
         padding_y: Vertical padding inside node boxes
+        gap: Space between nodes (default: 4)
 
     Returns:
         Rendered diagram as a string
@@ -104,7 +106,7 @@ def render(
 
         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)
+        return render_text(graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y, rounded_edges=rounded_edges, gap=gap)
     except Exception as exc:
         return f"[termaid] Failed to render diagram: {exc}"
 

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

@@ -34,6 +34,12 @@ def main(argv: list[str] | None = None) -> int:
         default=2,
         help="Vertical padding inside node boxes (default: 2)",
     )
+    parser.add_argument(
+        "--gap",
+        type=int,
+        default=4,
+        help="Space between nodes (default: 4). Use 1 or 2 for compact diagrams.",
+    )
     parser.add_argument(
         "--sharp-edges",
         action="store_true",
@@ -53,7 +59,7 @@ def main(argv: list[str] | None = None) -> int:
     parser.add_argument(
         "--version",
         action="version",
-        version="%(prog)s 0.1.3",
+        version="%(prog)s 0.2.1",
     )
 
     args = parser.parse_args(argv)
@@ -104,6 +110,7 @@ def main(argv: list[str] | None = None) -> int:
                     padding_x=args.padding_x,
                     padding_y=args.padding_y,
                     rounded_edges=not args.sharp_edges,
+                    gap=args.gap,
                 ))
 
         DiagramApp().run()
@@ -145,6 +152,7 @@ def main(argv: list[str] | None = None) -> int:
                 padding_x=args.padding_x,
                 padding_y=args.padding_y,
                 rounded_edges=not args.sharp_edges,
+                gap=args.gap,
             )
             print(result)
     except Exception as e:

{termaid-0.2.0 → termaid-0.2.1}/src/termaid/layout/grid.py

@@ -105,7 +105,8 @@ class GridLayout:
         return x + w // 2, y + h // 2
 
 
-def compute_layout(graph: Graph, padding_x: int = 4, padding_y: int = 2) -> GridLayout:
+def compute_layout(graph: Graph, padding_x: int = 4, padding_y: int = 2, gap: int = 4) -> GridLayout:
+    gap = max(gap, 1)  # minimum 1 for arrow visibility
     """Compute the grid layout for a graph."""
     layout = GridLayout()
     direction = graph.direction.normalized()
@@ -123,7 +124,7 @@ def compute_layout(graph: Graph, padding_x: int = 4, padding_y: int = 2) -> Grid
     _place_nodes(graph, layout, layer_order, direction)
 
     # Step 4: Compute column widths and row heights (with word wrapping)
-    _compute_sizes(graph, layout, padding_x, padding_y)
+    _compute_sizes(graph, layout, padding_x, padding_y, gap)
 
     # Step 4b: Normalize sizes (per-layer, capped)
     _normalize_sizes(graph, layout)
@@ -483,6 +484,7 @@ def _compute_sizes(
     layout: GridLayout,
     padding_x: int,
     padding_y: int,
+    gap: int = 4,
 ) -> None:
     """Compute column widths and row heights based on node content."""
     for nid, placement in layout.placements.items():
@@ -545,10 +547,10 @@ def _compute_sizes(
     max_row = max(all_rows) if all_rows else 0
     for c in range(max_col + 2):
         if c not in layout.col_widths:
-            layout.col_widths[c] = 4  # gap columns
+            layout.col_widths[c] = gap  # gap columns
     for r in range(max_row + 2):
         if r not in layout.row_heights:
-            layout.row_heights[r] = 3  # gap rows
+            layout.row_heights[r] = max(gap - 1, 1)  # gap rows
 
     # Expand gaps to fit edge labels
     _expand_gaps_for_edge_labels(graph, layout)

{termaid-0.2.0 → termaid-0.2.1}/src/termaid/output/text.py

@@ -11,6 +11,7 @@ def render_text(
     padding_x: int = 4,
     padding_y: int = 2,
     rounded_edges: bool = True,
+    gap: int = 4,
 ) -> str:
     """Render a graph to plain text."""
-    return render_graph(graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y, rounded_edges=rounded_edges)
+    return render_graph(graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y, rounded_edges=rounded_edges, gap=gap)

{termaid-0.2.0 → termaid-0.2.1}/src/termaid/renderer/draw.py

@@ -27,6 +27,7 @@ def render_graph(
     padding_x: int = 4,
     padding_y: int = 2,
     rounded_edges: bool = True,
+    gap: int = 4,
 ) -> str:
     """Render a graph to a string.
 
@@ -36,13 +37,14 @@ def render_graph(
         padding_x: Horizontal padding inside node boxes
         padding_y: Vertical padding inside node boxes
         rounded_edges: Use rounded corners on edge turns (╭╮╰╯ vs ┌┐└┘)
+        gap: Space between nodes (default: 4)
 
     Returns:
         The rendered diagram as a string
     """
     canvas = render_graph_canvas(
         graph, use_ascii=use_ascii, padding_x=padding_x, padding_y=padding_y,
-        rounded_edges=rounded_edges,
+        rounded_edges=rounded_edges, gap=gap,
     )
     if canvas is None:
         return ""
@@ -55,6 +57,7 @@ def render_graph_canvas(
     padding_x: int = 4,
     padding_y: int = 2,
     rounded_edges: bool = True,
+    gap: int = 4,
 ) -> Canvas | None:
     """Render a graph and return the Canvas (with style info).
 
@@ -77,7 +80,7 @@ def render_graph_canvas(
         graph.direction = Direction.LR
 
     # Layout
-    layout = compute_layout(graph, padding_x, padding_y)
+    layout = compute_layout(graph, padding_x, padding_y, gap)
 
     # Route edges
     routed = route_edges(graph, layout)