docs: 统一预扫描与模块链接注释措辞

crates/oxide_emit/src/prepass/block_fn.rs

@@ -9,8 +9,8 @@ use crate::Emitter;
 use oxide_parser::{Declaration, Statement, VariableDeclarationKind};
 
 impl Emitter {
-    /// 递归收集语句树内块级函数声明名（源序去重），供 web-compat 外层 var 绑定
-    /// 实例化。
+    /// 递归收集语句树内块级函数声明名（源序去重），供 sloppy 模式浏览器兼容行为
+    /// （块级函数声明建外层 var 绑定）下的外层 var 绑定实例化。
     ///
     /// # 边界与前提
     /// - 调用点直接子级（函数体/程序顶层直接子句）是提升 var 声明，非块级
@@ -189,8 +189,9 @@ impl Emitter {
         }
     }
 
-    /// 块级函数名 web-compat 外层绑定抑制集：形参名（含解构叶/rest）∪ 语句树内
-    /// 词法声明名。命中抑制的名字不建外层 var 绑定、不求值写回。
+    /// 块级函数名的外层 var 绑定抑制集（sloppy 模式浏览器兼容行为）：形参名
+    /// （含解构叶/rest）∪ 语句树内词法声明名。命中抑制的名字不建外层 var 绑定、
+    /// 不求值写回。
     pub(crate) fn collect_block_fn_suppressed_names(
         &self, statements: &[Statement], param_names: &HashSet<String>,
     ) -> HashSet<String> {

crates/oxide_emit/src/prepass/builtin_scan.rs

@@ -6,13 +6,16 @@ use crate::{CompileCtx, Emitter};
 use oxide_parser::{BindingPattern, Declaration, Expression, Statement};
 
 impl Emitter {
-    /// 在临时寄存器池之前分配 builtin 槽位。
+    /// 递归遍历程序 AST，把内置全局标识符引用预登记到固定寄存器槽（内置槽在临时
+    /// 寄存器池之前分配，两者隔离，槽位分配序稳定）。
     pub(crate) fn pre_register_builtin_references(&self, stmts: &[Statement], ctx: &mut CompileCtx) {
         for stmt in stmts {
             self.pre_scan_builtin_stmt(stmt, ctx);
         }
     }
 
+    /// 递归遍历语句树，登记其中的内置标识符引用：表达式语句、变量/函数/类声明、
+    /// 控制流各分支与模块导出声明。
     fn pre_scan_builtin_stmt(&self, stmt: &Statement, ctx: &mut CompileCtx) {
         match stmt {
             Statement::ExpressionStatement(es) => self.pre_scan_builtin_expr(&es.expression, ctx),
@@ -150,6 +153,8 @@ impl Emitter {
         }
     }
 
+    /// 递归遍历表达式树，登记其中的内置标识符引用：标识符、调用/构造、成员、可选链、
+    /// 对象/数组字面量与各类运算表达式。
     fn pre_scan_builtin_expr(&self, expr: &Expression, ctx: &mut CompileCtx) {
         match expr {
             Expression::Identifier(ident) => {
@@ -262,6 +267,8 @@ impl Emitter {
         }
     }
 
+    /// 遍历赋值目标，登记其中的内置标识符引用：标识符目标直接登记，成员目标只扫描
+    /// 对象与计算键（属性名不是标识符引用）。
     fn pre_scan_builtin_target(&self, target: &oxide_parser::SimpleAssignmentTarget, ctx: &mut CompileCtx) {
         match target {
             oxide_parser::SimpleAssignmentTarget::AssignmentTargetIdentifier(id) => {
@@ -286,6 +293,7 @@ impl Emitter {
         }
     }
 
+    /// 遍历可选链元素，登记链上成员访问、调用与实参中的内置标识符引用。
     fn pre_scan_builtin_chain(&self, element: &oxide_parser::ChainElement, ctx: &mut CompileCtx) {
         match element {
             oxide_parser::ChainElement::StaticMemberExpression(member) => {

crates/oxide_emit/src/prepass/declare.rs

@@ -27,10 +27,11 @@ impl Emitter {
         }
     }
 
-    /// 预声明单个 `var` 名：仅顶层（全局作用域）的 builtin 名落 builtin 镜像槽
-    /// （run 起点预载全局属性值），使 GDI 序言与声明点同步都用入口原值而非
-    /// fresh undefined 槽，现存值（NaN 等）不被抹；函数体内 builtin 名仍是局部
-    /// var 遮蔽（fresh 槽，不命中只读内置拦截）；其余名 fresh var 槽。
+    /// 预声明单个 `var` 名：仅顶层（全局作用域）的内置名落内置镜像槽（预载全局
+    /// 属性值的固定寄存器槽，本轮求值开始时预载），使 GlobalDeclarationInstantiation
+    /// （脚本顶层声明实例化）序言与声明点同步都用入口原值，而非程序求值前
+    /// define-if-absent 序列新建的 undefined 槽，现存值（NaN 等）不被抹；函数体内
+    /// 内置名仍是局部 var 遮蔽（新建槽，不命中只读内置拦截）；其余名新建 var 槽。
     pub(crate) fn predeclare_var_name(&self, name: &str, ctx: &mut CompileCtx) {
         if ctx.is_global_scope && CompileCtx::is_known_builtin(name) {
             let _ = ctx.lookup_or_builtin(name);

crates/oxide_emit/src/prepass/mod.rs

@@ -8,12 +8,15 @@ mod block_fn;
 mod builtin_scan;
 mod declare;
 
-/// 脚本顶层 lexical 声明（let/const/class）禁止使用的受限全局名：3 名静态集。
-/// 受限判定走规范自有属性臂：全局对象上 {configurable:false} 自有属性名（声明
-/// 实例化无法建立遮蔽绑定）——现行规范下恰为三常量；eval 与各 builtin 属性皆
-/// 可配置（合法遮蔽），不在此列。名基静态集（编译期不可查运行时描述符）。与
-/// BUILTIN_GLOBALS 语义不同（后者是 put 写拦截/双写名单），不互相派生，交叠
-/// 名由漂移守卫单测断言恒同步。
+/// 脚本顶层词法声明（`let`/`const`/`class`）禁止使用的受限全局名：`undefined`、
+/// `NaN`、`Infinity` 三名静态集。
+///
+/// 判定标准是全局对象上 `configurable:false` 的自有属性名：此类属性无法由声明
+/// 实例化建立遮蔽绑定，现行规范下恰为三常量；`eval` 与其余内置属性皆可配置，
+/// 可合法遮蔽。运行时无法查询全局对象描述符，名单必须编译期确定。
+///
+/// 与 `BUILTIN_GLOBALS` 语义不同：后者是写入拦截与双写名单，两份名单互不派生，
+/// 交叠名由 `restricted_lexical_names_within_builtin_globals` 单测断言恒同步。
 pub(crate) const RESTRICTED_GLOBAL_LEXICAL_NAMES: &[&str] = &["undefined", "NaN", "Infinity"];
 
 /// 脚本顶层 lexical 声明撞受限全局名 → SyntaxError（声明实例化期拒绝，整程序