RhoMD Docs Download

Changelog

Rho format spec + @rho/md library 的版本变化记录。 本表跟 GitHub Releases 同步。

Versioning

@rho/md 库 v0.x 是 pre-stable——任何 minor 版本都可能 spec breaking。

v1.0 起遵循 strict SemVer：

  • patch（1.0.x）：bug fix，spec 不变
  • minor（1.x.0）：新 capability，向后兼容
  • major（2.0.0）：可能 break

v0.6 — SVG scenes (2026-05-08)

新功能

  • ✨ SVG scene capability — 用 template svg: 写声明式 SVG 动画
    • mini DSL 表达式可在 SVG 属性里求值
    • 内置 SVG sanitizer（剥离 <script> / event 属性 / 外部 URL）
    • 配 timer 实现物理仿真 / 几何动画
  • 跑通 15 capability total

Examples

弹簧、单摆、行星轨道、电路示意——见 Examples gallery。

Breaking changes

无。

v0.5 — Timer animation (2026-04-22)

新功能

  • ✨ Timer 控件 — 自动跳变数值，驱动动画
    • 4 modes: loop / pause / once / pingpong
    • 与 chart / SVG 配合做 live animation
    • typical frame rate ~20 Hz

Bug fixes

  • 修 vega-lite chart 在 dark theme 下颜色异常

Breaking changes

无。

v0.4 — Computed values (2026-03-15)

新功能

  • ✨ computed 派生值 — computed name = expression
    • mini DSL 表达式：+ - * / pow sqrt sin cos pi 等
    • 三元式 cond ? a : b
    • 拓扑排序自动处理 dependency
    • 跨 template / chart 复用
  • ✨ Float accumulation fix —— template 输出格式化精度提升

Breaking changes

无。

v0.3 — Inner processor + nested DSL (2026-02-25)

新功能

  • ✨ 嵌套 DSL 全面 work——layout 内 callout、stepper 含 interact 等任意组合
  • ✨ registerInnerPlugin / registerAllInnerPlugins API（集成方需调）
  • ✨ STL syntax highlighting —— ```stl 6 色 token 高亮

Breaking changes

⚠️ 集成方必须调 registerAllInnerPlugins()——否则嵌套 DSL 不识别。已有集成需补这一行。

v0.2 — Shared state (namespace) (2026-02-10)

新功能

  • ✨ namespace —— 多 interact 块共享变量
  • ✨ 跨块 computed —— 派生值可跨 namespace 块引用
  • ✨ Modal width 选项 —— small / medium / large / full

Breaking changes

无。

v0.1 — Spec formalization (2026-01-28)

新功能

  • ✨ HTML 输出标准化 —— 所有 DSL 输出统一 class 命名（.rho-callout / .rho-layout-grid / .rho-tab / etc.）
  • ✨ CSS variables —— 主题化通过 CSS variables
  • ✨ Dark theme 支持

Breaking changes

⚠️ class 名从 .markview-* 改为 .rho-*——自定义 CSS 需更新。

v0.0 — Initial release (2026-01-15)

首发

  • ✨ 5 静态 capability：Callout / Layout / Annotate / Timeline / STL syntax
  • ✨ 7 交互 capability：Tabs / Stepper / Modal / Interact text / Interact + Vega-Lite / Shared state（基础）/ Nested DSL（基础）
  • ✨ Plain-text fallback 设计原则确立
  • ✨ PolyForm Noncommercial 1.0 license 决定（v0.6 正式 apply）

总计 12 capability（v0.6 增加 computed / timer / svg = 15）。

预告

下一步规划见 Roadmap。

主要计划：

  • v0.7：Audio / video embed（slider + native HTML5 media）
  • v0.8：可访问性增强（ARIA / keyboard nav 完善）
  • v0.9：Performance 优化 + lazy hydration default
  • v1.0：稳定 API 承诺 + conformance test pack

See also