lukilabs/beautiful-mermaid-swift

🖼️ Render Mermaid nguyên bản bằng Swift — không cần WebView

BeautifulMermaid render sơ đồ Mermaid thành ảnh, SVG và ASCII art hoàn toàn bằng Swift, dựa trên công cụ bố trí ELK.

BeautifulMermaid là phiên bản Swift bản địa của beautiful-mermaid, dùng elk-swift để xử lý bố cục đồ thị. Dự án hỗ trợ 6 loại sơ đồ: flowchart, state, sequence, class, ER, và biểu đồ XY. Không cần WebView hay JavaScript — toàn bộ logic bằng Swift.

✨ Điểm nổi bật

• 6 loại sơ đồ: Flowchart, State, Sequence, Class, ER, XY Charts
• Đa định dạng xuất: UIImage/NSImage, SVG, ASCII art
• 17 theme tích hợp: Tokyo Night, Dracula, Nord, Gruvbox, Catppuccin...
• Tùy nhập theme VS Code: Dùng ShikiTheme để tải bất kỳ theme Shiki nào
• Chế độ hai màu: Chỉ cần background + foreground, hệ thống tự sinh màu phụ
• Tích hợp SwiftUI: MermaidDiagramView với mô hình MermaidDiagram kiểu giá trị
• CALayer rendering: MermaidLayer dùng Core Graphics trực tiếp
• Hỗ trợ async: Các phương thức render đều có phiên bản bất đồng bộ

💡 Vì sao đáng chú ý

BeautifulMermaid khác biệt từ các giải pháp khác bởi cách tiếp cận hoàn toàn bản địa bằng Swift, tránh phụ thuộc WebView và JavaScript — giảm kích thước ứng dụng và tăng hiệu năng render. Với hệ thống theme linh hoạt từ hai màu cơ bản đến 17 theme sẵn có, dự án phù hợp cho các ứng dụng iOS/macOS cần nhúng sơ đồ Mermaid mà không muốn đưa engine web vào bundle.

#Mermaid #Swift #SwiftUI #Diagrams #OpenSource #TiniX