docs: 添加 Rustdoc 注释

crates/oxide_emit/src/expr/assignment.rs

@@ -1,3 +1,6 @@
+//! 赋值表达式 emit：简单 `=`、复合赋值与解构赋值（数组/对象 pattern）。
+//! 函数：`emit_assignment_expression`。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/call.rs

@@ -1,3 +1,6 @@
+//! 调用表达式 emit：普通/原生/`new`/`super` 调用与调用域分发。
+//! 函数：`emit_call_expression`、`emit_call_domain`。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/function/mod.rs

@@ -1,3 +1,7 @@
+//! 函数表达式域：箭头/普通函数/类表达式/`new` 表达式的 emit 与分发。
+//! 函数：`emit_arrow_function_expression`、`emit_function_expression`、
+//! `emit_class_expression`、`emit_new_expression`、`emit_function_domain`。
+
 use crate::{CompileCtx, Emitter, ParamSpec};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/identifier.rs

@@ -1,3 +1,5 @@
+//! 标识符表达式 emit：`emit_identifier_expression` 按绑定/builtin/全局解析寄存器。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/literal.rs

@@ -1,3 +1,6 @@
+//! 字面量表达式 emit：数字/字符串/布尔/null/正则 → 常量池或立即数。
+//! 整数走立即数编码（`is_int_literal`），其余入常量池。
+
 use crate::{is_int_literal, CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/member/mod.rs

@@ -1,3 +1,7 @@
+//! 成员访问域：静态/计算/私有字段成员与可选链表达式 emit 及分发。
+//! 函数：`emit_static_member_expression`、`emit_computed_member_expression`、
+//! `emit_private_field_expression`、`emit_chain_expression`、`emit_member_domain`。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/mod.rs

@@ -1,3 +1,8 @@
+//! 表达式编译域：表达式分发 + sequence/unsupported。
+//!
+//! `emit_expression` 按 `Expression` 变体分发到各子模块；本文件还处理
+//! 序列表达式（逐项求值取末值）与不支持表达式的报错。
+
 use crate::{CompileCtx, Emitter};
 use oxide_parser::Expression;
 

crates/oxide_emit/src/expr/object/array.rs

@@ -1,3 +1,5 @@
+//! 数组字面量 emit：`emit_array_expression` 逐元素求值并建数组（含 holes）。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/object/mod.rs

@@ -1,3 +1,5 @@
+//! 对象表达式域：对象/数组字面量子模块与域分发 `emit_object_domain`。
+
 use crate::{CompileCtx, Emitter};
 use oxide_parser::Expression;
 

crates/oxide_emit/src/expr/object/object_literal.rs

@@ -1,3 +1,5 @@
+//! 对象字面量 emit：`emit_object_expression` 逐属性定义（含 getter/setter/展开）。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/operator/mod.rs

@@ -1,3 +1,7 @@
+//! 运算符域：二元/一元/条件/逻辑/更新/`in` 表达式 emit 与分发。
+//! 逻辑与 `??` 用短路跳转，复合求值利用 `is_side_effect_free` 优化。
+//! 函数：`emit_operator` 及各类 `emit_*_expression`。
+
 use crate::{is_side_effect_free, BinaryOperator, CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/parenthesized.rs

@@ -1,3 +1,5 @@
+//! 括号表达式 emit：`emit_parenthesized_expression` 透传内层表达式。
+
 use crate::{CompileCtx, Emitter};
 
 impl Emitter {

crates/oxide_emit/src/expr/template/mod.rs

@@ -1,3 +1,5 @@
+//! 模板字符串域：普通/标签模板子模块与域分发 `emit_template_domain`。
+
 use crate::{CompileCtx, Emitter};
 use oxide_parser::Expression;
 

crates/oxide_emit/src/expr/template/tagged.rs

@@ -1,3 +1,5 @@
+//! 标签模板表达式 emit：`emit_tagged_template_expression` 构造 template object 并调用标签函数。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/template/template_literal.rs

@@ -1,3 +1,6 @@
+//! 模板字面量 emit：`emit_template_literal_expression` 生成 TEMPLATE_STR 指令
+//! 拼接字面量段与内插表达式。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;

crates/oxide_emit/src/expr/this.rs

@@ -1,3 +1,5 @@
+//! `this` 表达式 emit：`emit_this_expression` 解析当前函数的 this 寄存器。
+
 use crate::{CompileCtx, Emitter};
 use oxide_ir::inst::Inst;
 use oxide_ir::operand::Operand;