docs: explain Tessera modules and execution flows in Chinese

src/render/scroll.rs

@@ -1,3 +1,6 @@
+//! 逐 Mount 的滚动状态、裁剪和输入目标选择。
+//! 共享组件的不同出现保留独立偏移。嵌套滚动先选择可接收位移的内层，偏移在实际内容范围内钳制。
+//!
 //! Per-occurrence scroll state and a single geometry/clip projection shared by
 //! native paint, source paint and input. No business object is copied.
 use crate::{
@@ -12,6 +15,7 @@ use endor_core::{NativeContext, ObjectRef, Value, Vm, VmError, WeakObjectRef};
 use std::collections::HashMap;
 
 #[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
+/// 滚动容器允许响应的轴，不决定其业务内容组成方向。
 pub enum Axis {
     #[default]
     Both,
@@ -19,6 +23,7 @@ pub enum Axis {
     Horizontal,
 }
 impl Axis {
+    /// 返回内部枚举或对象对应的稳定源名称。
     pub fn name(self) -> &'static str {
         match self {
             Self::Both => "both",
@@ -26,6 +31,7 @@ impl Axis {
             Self::Horizontal => "horizontal",
         }
     }
+    /// 把外部源码或属性表示转换为内部枚举/结构，并反馈不支持的输入。
     pub fn parse(name: &str) -> Result<Self, VmError> {
         match name {
             "both" => Ok(Self::Both),
@@ -36,14 +42,17 @@ impl Axis {
             )),
         }
     }
+    /// 判断滚动轴配置是否允许该方向移动，避免同时把禁用轴纳入滚动范围。
     pub fn horizontal(self) -> bool {
         self != Self::Vertical
     }
+    /// 判断滚动轴配置是否允许该方向移动，避免同时把禁用轴纳入滚动范围。
     pub fn vertical(self) -> bool {
         self != Self::Horizontal
     }
 }
 
+/// 求两个裁剪矩形的交集，空区域仍保持合法非负尺寸。
 fn intersection(a: [f32; 4], b: [f32; 4]) -> [f32; 4] {
     let x = a[0].max(b[0]);
     let y = a[1].max(b[1]);
@@ -54,6 +63,7 @@ fn intersection(a: [f32; 4], b: [f32; 4]) -> [f32; 4] {
         (a[1] + a[3]).min(b[1] + b[3]).max(y) - y,
     ]
 }
+/// 沿出现树累计滚动偏移和裁剪；遇到独立场景视口时按其有限边界重新建立投影范围。
 pub fn project(vm: &mut Vm, table: &MountTable, root: &UiNode, frame: &mut Frame) -> Result<()> {
     let mut nodes = HashMap::new();
     let mut work = vec![root];
@@ -201,6 +211,7 @@ pub fn project(vm: &mut Vm, table: &MountTable, root: &UiNode, frame: &mut Frame
     Ok(())
 }
 
+/// 把源滚动值解码为有限坐标，阻止非数或越界值进入投影。
 pub fn coordinate(value: &Value) -> Result<f32, VmError> {
     let Value::Number(value) = value else {
         return Err(VmError::InvalidArgument(
@@ -216,6 +227,7 @@ pub fn coordinate(value: &Value) -> Result<f32, VmError> {
     }
     Ok(n)
 }
+/// 更新指定出现的滚动偏移，并钳制到本轴实际可滚动的内容范围。
 pub fn set(
     cx: &mut NativeContext<'_>,
     owner: ObjectRef,
@@ -249,6 +261,7 @@ pub fn set(
     cx.replace_payload(owner, mount)?;
     cx.set_attr(desktop, "scrollRequested", Value::Bool(true))
 }
+/// 沿祖先滚动容器调整偏移，让目标出现进入可见范围。
 pub fn into_view(
     cx: &mut NativeContext<'_>,
     owner: ObjectRef,
@@ -302,6 +315,7 @@ pub fn into_view(
     }
     Ok(())
 }
+/// 按逆出现顺序选择指针处可处理当前滚动方向的最内层容器。
 pub fn wheel_target(frame: &Frame, point: Point, delta: [f32; 2]) -> Option<u64> {
     let indices: HashMap<_, _> = frame.mounts.iter().map(|mount| (mount.id, mount)).collect();
     let mut current = frame