#MoonLayout

#使用

moon add ShiChengxu/moonlayout@0.2.0

let style = @ml.LayoutStyle::new(16, wrap_algorithm=Optimal, alignment=Justify)
let hyphenator = @ml.Liang::english() // 编译一次，重复使用
let lines = @ml.layout_hyphenated("Hyphenation improves narrow paragraphs.", style, hyphenator)
for line in lines {
  println(line.aligned_text)
}

#可选 Unicode 集成

let result = @integration.layout(
  "שלום 123 Ａ",
  @ml.LayoutStyle::new(16),
  normalization=NFKC,
  bidi=true,
)
for line in result.lines {
  println(line.aligned_text)
}

#能力与坐标约定

• Unicode 17 UAX #14 断行以及 UAX #29 词／句边界；21,794 个官方用例全量验证。
• 贪心与简化最优换行、可插拔 Hyphenator、左／右／居中／两端对齐和基础 CJK 字间距分配。
• 所有 start/end 和边界位置都是 UTF-8 字节偏移，不能直接用于 MoonBit UTF-16 字符串切片。
• Line.source 保留逻辑原文；普通布局拼接各行 source 等于输入。集成布局的区间和 source 对应 LayoutResult.logical_text；原始输入另存为 original_text，不提供归一化前后的逐字符反向映射。
• Line.text 为逻辑显示内容，行尾空白和硬换行已去掉，tab 已展开，选中的连字符已插入；aligned_text 为最终显示文本，width 为其显示列数。BiDi 只改变最终视觉输出。
• 空输入返回 []；宽度 ≤ 0 按 1 处理；不可分割的超宽字素允许溢出；末尾硬换行保留最终空行。
• words 返回含字母或数字的段，segments(..., Word) 保留全部段。连字符插件收到完整词边界段，返回词内 UTF-8 偏移；无效或字素内部断点被过滤。

#八个示例

moon run examples/wrap_terminal
moon run examples/cjk_mixed
moon run examples/justify_paragraph
moon run examples/word_boundaries
moon run examples/hyphen_wrap
moon run examples/optimal_wrap
moon run examples/bidi_paragraph
moon run examples/markdown_like

#验证与基准

python scripts/verify.py
moon bench -p ShiChengxu/moonlayout/benchmarks --target native --release