誊章

xrune-fmt（誊章）是 ui! { … } 块的格式化器。一个 CLI 二进制，不是 lib 库，装一次，对准任何含咏唱宏的 .rs 文件。

cargo install xrune-fmt

xrune-fmt src/app.rs            # 原地重写
xrune-fmt src/app.rs --check    # 未格式化则退出码 1，文件不动

它做什么

对每段 ui! { … }，誊章会：

1. 用正则 ui!\s*\{ 找到宏，配对的 } 靠 brace 深度计数。
2. 把里面的内容交给真正的 parser，xrune-nexus 的 DsRoot::parse，拿回一棵 DsTree。
3. 遍历这棵树，按统一缩进、换行、间距重发。
4. 如果 parser 拒收，整段保持原样。誊章绝不默默改写自己读不懂的块。

它只动 ui! { … } 体内的内容。宏外面的代码按字节保留。

格式化规则

• 上下文头始终多行，每属性独占一行，缩进比 ui! 大括号多一级。
• 部件属性：单行能装下且 ≤ MAX_LINE_WIDTH = 100 时单行；否则每属性独占一行。原文已经多行的，即便重排后单行也能装下，誊章仍保持多行，作者意图优先于列宽。
• 属性值、walk 可迭代、if/match 匹配表达式、on 事件体按 Rust 格式排版，保留内部层级缩进。
• on EventKind 子句按声明顺序放在部件的子节点块后。没有子节点时，放在属性或附魔后。事件体保留自己的大括号，包括空事件体；回调形式不添加事件体。
• 附魔坐落在属性与 body 之间，写在 [ … ]，逗号分隔。

use xrune::ui;
fn handler() {}
fn app(parent: i32) {
ui! {
    :(
        parent: parent
    :)
Panel () {
    Text ("child")
} on Tap(handler)
}
}
fn main() {}

格式器将子节点块放在事件后缀之前。紧跟 on Tap(handler) 的大括号属于事件体，不是部件的子节点。

格式化保留部件属性、附魔、事件处理器和子节点的结构。对已格式化的代码再次格式化，输出不变。

为什么单独养一个跟随 parser 形态的消费者

誊章是同一棵 DsTree 的第二位消费者。第一位是你的符文师（DsRune 实现 + decipher）。誊章不实现 DsRune，它手动遍历这棵树，因为它的目标是重发语法，不是把树翻成运行时代码。

这也是为什么誊章是语言改动的金丝雀：parser 多认一种新形态，誊章就得跟着把对应字段读出来；AST 长一个新节点，誊章就要加一个 arm。要往 xrune-nexus 加东西时，先看一眼誊章，掂量一下下游连带工作量。

源码出处

• CLI + ui! 块抽取：crates/xrune_fmt/src/main.rs
• 树遍历 + 重发：crates/xrune_fmt/src/formatter.rs