Skip to main content

moqi-uml · Self-Built Diagram Engine

moqi-uml

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实现备注
① ParserJSON 前端.moqdiag Rust 前端为保留实现,尚未完成
② Validatesrc/model/validate.ts · 6 条规则error / warning / hint 三级
③ Semantic IRsrc/model/types.ts · src/compiler/json.tsTypeScript interface,零依赖
④ LayoutRust/WASM Sugiyama 四阶段破环 → 分层 → 减交叉 → 圆角肘形路由
⑤ Render SVGsrc/renderers/svg/emit-svg.ts确定性单文件 SVG 字符串
⑥ Render Reactsrc/renderers/react/Diagram.tsx · CodeDiagram交互式画布

7 NodeKinds · 5 Presets · 2 Themes = 10 Palettes

NodeKind 是我们的最小语义集,覆盖主流架构图词汇:

Kind示例颜色(classic-dark)
frontendBrowser / Mobile App蓝色
backendAPI Server / Microservice绿色
databasePostgreSQL / Redis紫色
cloudCDN / Load Balancer / Kubernetes青色
securityOAuth / WAF / API Gateway橙色
messagebusKafka / 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