Beautiful-mermaid : Un moteur de rendu sans DOM pour le terminal et le web

Le Pitch

Beautiful-mermaid est un portage TypeScript de la bibliothèque Go "mermaid-ascii" d'Alexander Grooff, conçu pour s'affranchir des dépendances DOM lourdes du moteur officiel. L'outil génère du SVG pour les interfaces web et de l'ASCII/Unicode pour les terminaux ou les interfaces de chat AI (GitHub).

Sous le capot

Le principal atout technique réside dans l'absence totale de dépendance au DOM, ce qui rend la bibliothèque nativement compatible avec Node.js, Bun et les environnements navigateurs sans utiliser de navigateur headless (GitHub/Luki Labs). L'implémentation inclut 15 thèmes intégrés et une compatibilité totale avec Shiki pour le styling, garantissant une cohérence visuelle avec les éditeurs modernes comme VS Code (Project Docs).

Côté performance, l'équipe annonce un rendu de 100 diagrammes en moins de 500ms, une latence quasi nulle indispensable pour les pipelines de CI/CD ou les réponses LLM en streaming (Dossier UsedBy). Le moteur a étendu la logique Go initiale pour supporter les diagrammes de séquence, de classes et les schémas entité-association (GitHub).

Tout n'est pas encore au point sur la gestion de la spécification Mermaid. Des bugs de rendu critiques ont été signalés sur la syntaxe stateDiagram-v2, notamment pour les transitions initiales de type [*] --> qui brisent le moteur (HN Comment). Par ailleurs, le rendu ASCII/Unicode reste structurellement limité par la grille de caractères, ce qui rend les diagrammes complexes illisibles dès qu'on dépasse quelques nœuds (HN Comment).

On manque encore de visibilité sur deux points :
- Les benchmarks comparatifs réels face au moteur officiel Mermaid v11+ (missing_info).
- La roadmap pour le support des Gantt, Mindmaps ou Quadrant charts (missing_info).
- La pérennité du projet, celui-ci étant étroitement lié au développement de "Craft Agents" (Dossier UsedBy).

L'avis de Ruben

C'est un outil indispensable pour vos CLI ou pour injecter proprement des diagrammes dans les contextes de fenêtres de chat AI, mais ne l'utilisez pas pour remplacer Mermaid-JS sur une documentation technique complexe. Les régressions sur les diagrammes d'états et l'absence de support de la spec complète sont rédhibitoires pour une migration totale en production. C'est un excellent side-project de Luki Labs, mais le risque de maintenance est réel si leur produit principal pivote.

Codez propre,
Ruben.