moqi-uml · Self-Built Diagram Engine
One Kernel, Many Frontends, Many Renders
Code Sgram (DSL) + Scratch Sgram (Canvas) — dual-mode architecture diagramming powered by a single Rust/WASM Sugiyama layout engine.
Model / View Separation
moqi-uml 的核心原则:model owns truth, view owns presentation.
- SemanticDiagram (model) — 唯一真相源,由前端产出(JSON / Mermaid 编译或画布手动编辑)。不携带坐标。
- LayoutIR (view) — 派生层,由 Rust/WASM Sugiyama 布局引擎计算产出。每次渲染时重新生成。
- 两个渲染目标(
emitSvg→ 静态 SVG 字符串,React Flow → 交互式画布)直接消费 LayoutIR;节点样式与配色来自 SemanticDiagram 的 NodeKind、preset 与 theme。
Six-Stage Compilation Pipeline
Source → Parse → Validate → Semantic IR → Rust/WASM Layout → Render
↑ code path ↑ model ↑ view ↑ output
当前状态(M0–M3 完成):
| Stage | 实现 | 备注 |
|---|---|---|
| ① Parser | JSON 前端 | .moqdiag Rust 前端为保留实现,尚未完成 |
| ② Validate | src/model/validate.ts · 6 条规则 | error / warning / hint 三级 |
| ③ Semantic IR | src/model/types.ts · src/compiler/json.ts | TypeScript interface,零依赖 |
| ④ Layout | Rust/WASM Sugiyama 四阶段 | 破环 → 分层 → 减交叉 → 圆角肘形路由 |
| ⑤ Render SVG | src/renderers/svg/emit-svg.ts | 确定性单文件 SVG 字符串 |
| ⑥ Render React | src/renderers/react/Diagram.tsx · CodeDiagram | 交互式画布 |
7 NodeKinds · 5 Presets · 2 Themes = 10 Palettes
NodeKind 是我们的最小语义集,覆盖主流架构图词汇:
| Kind | 示例 | 颜色(classic-dark) |
|---|---|---|
frontend | Browser / Mobile App | 蓝色 |
backend | API Server / Microservice | 绿色 |
database | PostgreSQL / Redis | 紫色 |
cloud | CDN / Load Balancer / Kubernetes | 青色 |
security | OAuth / WAF / API Gateway | 橙色 |
messagebus | Kafka / RabbitMQ | 黄色 |
external | 第三方服务 | 灰色 |
Preset 决定视觉风格(classic / signal-flow / blueprint / editorial / openai),theme 决定明暗(dark / light)。语义(NodeKind)和渲染(preset/theme)完全解耦——同一个 backend 节点可以用 10 种不同的视觉呈现。
快速示例:电商架构 C4 Container Diagram
下面用一个完整的例子展示 Expression → Semantic → Render 的四阶段管线。输入是一段 JSON(当前唯一前端),输出是确定性 SVG。
Source — JSONJSON frontend