docs: explain native visual protocols and legacy page coordinate rules

src/render/mod.rs

@@ -1,4 +1,7 @@
 //! 渲染模块入口。排版、源视觉协议、相机投影和最终光栅化各自独立，通过不可变帧衔接。
+//! 调用链：model/snapshot 提供不可变 UiNode，layout/source_layout 求几何，source_paint 产出发布命令。
+//! document 转成 display_list 后由 software_renderer 光栅化；scene 组合窗口壳层，viewport/scroll 与输入复用坐标规则。
+//! main.rs 的 crate 根重导出保留现有内部路径；image/text_flow 另以 render 子模块路径供桥接调用。
 //!
 // 目录确定模块归属；main 中的 crate 根别名保持内部调用路径稳定。
 /// 计算边框、内外边距和内容区域，并应用容器主轴/交叉轴分配规则。
@@ -32,5 +35,7 @@ pub(crate) mod text;
 /// 处理二维场景相机、局部视口投影和空间查询，供绘制与命中使用相同变换。
 pub(crate) mod viewport;
 
+/// 解码与缓存不可变 RGBA 资源、预渲染文字，并提供带 alpha 的纹理采样与轮廓。
 pub mod image;
+/// 以预备字词图片和避让轮廓安排自由文字排版，几何与输出绘制资源分开保留。
 pub mod text_flow;