#NoahLiu/yoga-mbt

#定位

• 只对齐 Web Flexbox 标准（CSS Flexible Box Layout Module Level 1）， 不保留 Yoga 的「yoga 默认值 / web 默认值」双标准。默认值一律 web 语义： flex-direction: row、flex-shrink: 1、flex-basis: auto、 align-items: stretch、min-width/height: auto（内容下限）。
• 弹性解析（§9.7）按规范逐条实现：目标尺寸从 flex base 起步、不弹性项 预冻结、按总违规正负选择性冻结、shrink 加权用内基准尺寸、弹性因子和 小于 1 时以「初始剩余空间 × 因子和」封顶。与 Yoga 内核的两遍法（官方 注释自认偏离规范）有意不同。
• 纯 MoonBit 零 FFI，无 prebuild 无链接参数，所有 target 可用。
• 宽高语义为 border-box（width/height 含自身 padding 与 border，与 Yoga 一致）；百分比相对父容器内容区对应轴尺寸。
• aspect-ratio 的比例同样按 border-box 计算（ratio = 边框盒宽 /边框盒高），与 CSS 默认的 content-box 比例不同。

#用法

// moon.mod: import "NoahLiu/yoga-mbt@0.1.0"
let root = @yoga.Node::new()
root.set_width(@yoga.percent(100.0))
root.set_height(@yoga.percent(100.0))

let child = @yoga.Node::new()
child.set_measure(fn(avail_w, _avail_h) {
  // 返回内容尺寸（不含自身 padding/border，引擎负责叠加）
  (120.0, 24.0)
})
root.append_child(child)

@yoga.calculate_layout(root, Some(800.0), Some(600.0))
let l = child.layout()   // left / top 相对父边框盒；width / height 边框盒

• 叶子节点（无子节点）通过 set_measure 提供内容测量；入参为可用宽高 （None 表示该方向不受约束，可用于文本折行推算高度）。 内在尺寸用同一函数探询：求 max-content 时两个入参都给 None，求 min-content 时请求的那一轴给 Some(0.0)、另一轴给 None——文本应回 最长词宽、图片应回不缩放的原始宽；忽略入参恒回固定尺寸的测量函数， 其 min-content 与 max-content 相同。
• min_content() / max_content() / fit_content() 是取值辅助，可用于 set_width / set_height / set_min_* / set_max_* / set_flex_basis： width: max-content 给内容不折行的尺寸（超出可用空间也不压窄，允许溢出）， width: min-content 给「不溢出」的最小尺寸，fit-content 按 clamp(min-content, 可用空间, max-content)。父容器该轴不受约束时 fit-content 退化为 max-content。主轴基准（flex-basis: auto 且主轴尺寸 也 auto）取 max-content，min-width/height: auto 取 min-content。 关键词用在 margin / padding / border / inset 上按未设置（0）处理； stretch 关键词未实现。
• 文本类叶子再通过 set_baseline 提供基线：入参与 set_measure 相同， 返回基线到内容盒顶部的距离（不含自身 padding/border，引擎负责叠加）， 返回 None 表示该节点无基线。容器节点无需设置——它的基线由引擎按规范 从内部项推出。
• set_aspect_ratio(Some(宽/高)) 给首选宽高比：只要有一轴尺寸确定（显式给出， 或由父级弹性解析钦定），另一轴就按比例换算，压过内容推算；None 或非正数 表示不设比例。默认的 align-items: stretch 会覆盖交叉轴上的比例结果， 要保持比例需给非 stretch 的对齐（flex-start / center / flex-end） 或显式交叉尺寸。
• set_direction(Rtl) 设本节点的书写方向：行容器主轴起端落到右侧、列容器 交叉轴起端落到右侧；与 RowReverse / ColumnReverse 叠加时按两次翻转走。 方向只管本节点排布子项，不做 CSS 的 direction 继承；margin 与 top/right/bottom/left 仍是物理边，其「起端 / 末端」含义随方向换算。
• 根节点宽高是 Option[Double]，None 表示该方向不约束、按内容取尺寸； 需要撑满可用空间时给根设置 percent(100.0)。
• 样式枚举可直接传入：node.set_flex_direction(@yoga.FlexDirection::Column) 或简写 @yoga.Column（枚举按 pub(all) 导出，外部包可构造）。
• 布局结果 node.layout() 需在 calculate_layout 之后读取。
• set_pixel_grid(1.0) 打开像素网格取整（只对作为布局根的节点生效， 0.0 / 负数为关闭）：布局结束后按绝对边框取整再回推相对坐标，等分 100 / 3 会得到 33 / 34 / 33 这类和为总宽的整数尺寸，相邻项共用边 取整一致故不留缝。不做 Yoga 的贴父末端回推补偿，因此贴到容器内缘尽头 的项，其取整后的末端边与父内缘可能差一个网格单位以内。
• 改样式后直接再调一次 calculate_layout 即可：引擎内部有测量缓存，但每次 布局入口会自动整树清一次，不需要手动通知失效。

#已实现

#未实现（按批次补）

• stretch 尺寸关键词（css-sizing-4，Yoga 有、Web 侧与 auto + align-self: stretch 语义重叠，暂不做）
• 内在尺寸递归中的百分比近似：子项的百分比尺寸只在父容器该轴尺寸确定时 可解析，父容器该轴 auto 时按不解析（走内容）处理；父链回环那套 css-sizing-3 §5.2.1 规则未实现
• flex 容器内在尺寸的「ideal / web-compatible」双算法（细则只存在于 css-flexbox-2 草案，本引擎按 css-sizing-3 的通用内在尺寸规则单套实现）

#开发

cd modules/yoga-mbt
moon check src --deny-warn   # 零警告（在本模块目录内查，别裸跑 moon check：
                             # 本仓同时有主项目，裸跑会连带把主包编进来）
moon test src                # 全绿（预期值按规范手算）

# 性能基线：1121 节点树（20 组 × 11 行 × 每行 5 节点，含 baseline/grow/gap），
# 三个场景各 500 轮并打印每轮 µs：
#   steady   同参数重复布局（干净整树跳过）
#   one_leaf 每轮改一个叶子的内容（只重排那条链）
#   resize   每轮换根的显式宽（全树重排，等价于旧口径的成本基线）
moon run bench            # debug
moon run --release bench  # release