#MoonFluent

#安装与导入

moon add chenliyi-cly/moonfluent@0.2.1

import {
  "chenliyi-cly/moonfluent" @ftl,
}

pkgtype(kind: "executable")

moon 0.1.20261028 (e1e1f15 2026-10-28)
moonc v0.10.18+6c83a7f62 (2026-10-28)
moonrun 0.1.20261028 (e1e1f15 2026-10-28)

#应用快速开始：真正生成本地化消息

import {
  "chenliyi-cly/moonfluent/runtime",
  "chenliyi-cly/moonfluent/intl",
}
options(is_main: true)

///|
fn main {
  let bundle = @runtime.Bundle::new("en-US", @intl.provider(), use_isolating=false)
  let errors = bundle.add_resource("hello = Hello { $name }!\nitems = { $count ->\n    [one] One item\n   *[other] { NUMBER($count) } items\n}\n")
  if !errors.is_empty() { abort("Invalid FTL") }
  let result = bundle.format("hello", arguments={"name": @runtime.Text("Alice")})
  println(result.value) // Hello Alice!
  println(bundle.format("items", arguments={"count": @runtime.number(1234)}).value)
  // 1,234 items
}

#三个可执行运行时场景

moon run examples/runtime_ui --target js
moon run examples/runtime_invoice --target js
moon run examples/runtime_reports --target js

1. 界面翻译：中文 FTL、用户变量、品牌术语、控件属性和文件数量 → bundle 解析/引用/数字格式化 → 小陈，欢迎使用 MoonFluent。、打开 MoonFluent、已同步 1,234 个文件。
2. 通知与账单：英文 FTL、客户名、类型化 USD 数字与 UTC epoch 毫秒 → NUMBER/DATETIME 和复数 → Invoice for Ada: $1,234.50、Due October 20, 2026、2 items。
3. 批量报表：法语/英语资源链、记录数和缺失键 → 当前 locale 消息求值、整条消息回退、缺键诊断 → 2 lignes、Report complete 和可记录的错误，不把缺失引用当成功。

#稳定公共入口

#目标平台

#场景一：编辑器容错诊断与位置转换

moon run examples/editor

fn main {
  let source = "# 😀\nbad = { $ }\nvalid = Welcome\n"
  let root = @ftl.parse(source)
  let map = @ftl.SourceMap::new(source)
  let visits = match root.walk() {
    Ok(v) => v
    Err(_) => abort("遍历失败")
  }
  let mut errors = 0
  for visit in visits {
    match visit.node.kind {
      Annotation(code, _, message) => {
        let position = map.position(visit.node.span.start) catch {
          _ => abort("诊断位置无效")
        }
        println("\{code} at \{position.line}:\{position.character}: \{message}")
        errors += 1
      }
      _ => ()
    }
  }
  let catalog = match @ftl.Catalog::build(root) {
    Ok(c) => c
    Err(_) => abort("索引失败")
  }
  if errors != 1 ||
    catalog.find(@ftl.MessageSymbol, "valid").length() != 1 {
    abort("错误恢复结果不符合预期")
  }
  println("保留了一个诊断和后续有效消息")
}

#场景二：翻译维护中的结构化重命名

moon run examples/translation

fn main {
  let input = "# old must remain a comment\nold = 你好 { $old }\nuse = { old } / old stays text\n"
  let root = @ftl.parse(input)
  let renamed = match root.rename_symbol(@ftl.MessageSymbol, "old", "welcome") {
    Ok(n) => n
    Err(_) => abort("重命名被拒绝")
  }
  let output = @ftl.serialize_checked(renamed) catch {
    _ => abort("输出无法保持严格语法往返")
  }
  if !output.contains("# old must remain a comment") ||
    !output.contains("{ $old }") ||
    !output.contains("{ welcome }") ||
    !output.contains("old stays text") {
    abort("修改了不应修改的内容")
  }
  let catalog = match @ftl.Catalog::build(@ftl.parse(output)) {
    Ok(c) => c
    Err(_) => abort("输出索引失败")
  }
  if catalog.find(@ftl.MessageSymbol, "welcome").length() != 1 ||
    !catalog.missing_references().is_empty() {
    abort("往返检查失败")
  }
  println(output)
}

#场景三：构建阶段的资源索引与引用检查

moon run examples/build_index

fn main {
  let input = "-brand = Moon\nheadline = { -brand }\nheadline = Duplicate\nbutton =\n    .label = Open\npage = { button.label } { missing }\n"
  let catalog = match @ftl.Catalog::build(@ftl.parse(input)) {
    Ok(c) => c
    Err(_) => abort("索引失败")
  }
  let duplicates = catalog.duplicates()
  let missing = catalog.missing_references()
  if duplicates.length() != 1 ||
    missing.length() != 1 ||
    catalog.references().length() != 3 {
    abort("索引结果不符合预期")
  }
  println("重复定义：\{duplicates[0].name}")
  println("资源内未解析引用：\{missing[0].reference.name}")
  for definition in catalog.definitions() {
    println("定义：\{definition.name}，属性数：\{definition.attributes.length()}")
  }
}

#序列化与校验边界

#验证与复现

moon version --all
moon check
moon test
moon run examples/editor
moon run examples/translation
moon run examples/build_index
moon package --list

• 39 个上游 fixture 对完整 AST JSON（含 span、诊断与恢复内容）做比较；
• 同一组 39 个 fixture 分别检查两种 Junk 模式，共 78 组 serializer 期望比较，组织为 39 个测试；
• 201 个额外输入与独立 Python 实现做完整 AST 差分；
• 1 个 seeded 随机输入测试内部执行 2000 例，检查恢复、位置范围和输出可解析性，不是 2000 个独立测试，也不是 2000 例 Python 差分。

#0.2.0 修复验证（2026-10-20）

#进一步阅读与许可

• pkg.generated.mbti：完整公共 API。
• docs/architecture.md：分层、遍历顺序、坐标与错误模型。
• SECURITY.md：输入信任边界、资源限制和报告建议。
• AI_USAGE.md：AI 辅助开发范围与可核查依据。
• CHANGELOG.md：版本能力和已知限制。
• THIRD_PARTY.md、NOTICE、LICENSE：上游来源、修订和 Apache-2.0 归属。