404 lines
20 KiB
Rust
404 lines
20 KiB
Rust
//! 解构绑定/赋值 emit：数组与对象 pattern 的绑定初始化、rest 收集与解构赋值。
|
||
//! 函数：`emit_bind_target`、`emit_binding_pattern`、`emit_array_binding`、
|
||
//! `emit_object_binding`、`emit_assign_target` 等。
|
||
|
||
use crate::{CompileCtx, Emitter};
|
||
use oxide_bytecode::module::Constant;
|
||
use oxide_bytecode::opcode::OpCode;
|
||
use oxide_ir::inst::Inst;
|
||
use oxide_ir::operand::Operand;
|
||
use oxide_parser::{
|
||
ArrayAssignmentTarget, ArrayPattern, AssignmentTarget, AssignmentTargetMaybeDefault, AssignmentTargetProperty,
|
||
BindingPattern, Expression, ObjectAssignmentTarget, ObjectPattern, VariableDeclarationKind,
|
||
};
|
||
|
||
impl Emitter {
|
||
pub(crate) fn emit_default_if_undefined(
|
||
&self, val_reg: u32, default_expr: &Expression, name: Option<&str>, ctx: &mut CompileCtx,
|
||
) -> Result<u32, String> {
|
||
let undef_reg = self.emit_undefined(ctx);
|
||
let eq_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(
|
||
OpCode::STRICT_EQ,
|
||
Operand::Reg(eq_reg),
|
||
Operand::Reg(val_reg),
|
||
Operand::Reg(undef_reg),
|
||
));
|
||
// val != undefined（eq 为 false）→ 跳过默认值
|
||
let end_label = ctx.next_label_id();
|
||
ctx.inst(Inst::jmp_if_false(eq_reg, end_label));
|
||
let default_reg = self.emit_expression(default_expr, ctx)?;
|
||
// 默认值表达式是匿名函数/箭头/class 时按绑定名推断 name（SetFunctionName）。
|
||
if let Some(name) = name {
|
||
if crate::is_anonymous_function_definition(default_expr) {
|
||
if let Some(sub_mod) = ctx.nested.last_mut() {
|
||
if sub_mod.function_name.is_none() {
|
||
sub_mod.function_name = Some(name.to_string());
|
||
}
|
||
}
|
||
}
|
||
}
|
||
ctx.inst(Inst::new(
|
||
OpCode::LOAD_VAR,
|
||
Operand::Reg(val_reg),
|
||
Operand::Reg(default_reg),
|
||
Operand::None,
|
||
));
|
||
ctx.labels.set_label_pos(end_label, ctx.insts.len());
|
||
Ok(val_reg)
|
||
}
|
||
|
||
/// 绑定单个标识符到槽位。`fresh_cell` 为 true 时对被捕获绑定用 MAKE_CELL_FRESH
|
||
/// （循环每迭代绑定：无条件新建 cell，本迭代闭包捕获新 cell）。
|
||
pub(crate) fn emit_bind_target(
|
||
&self, name: &str, src_reg: u32, kind: VariableDeclarationKind, is_const: bool, fresh_cell: bool,
|
||
ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
let target_reg = if matches!(kind, VariableDeclarationKind::Var) {
|
||
// `var` 名已预声明（hoisting），复用预登记槽位而非新分配，使 n_registers 与 let/const 一致。
|
||
if let Some(reg) = ctx.scopes.symbols.lookup_any(name) {
|
||
reg
|
||
} else {
|
||
let var_reg = ctx.alloc_reg();
|
||
ctx.declare(name, var_reg, kind, is_const)?;
|
||
var_reg
|
||
}
|
||
} else {
|
||
// let/const：本块预声明（TDZ 占位）则复用预登记槽位，不重复 declare；
|
||
// 否则（for 头等未预声明路径）按原逻辑声明。
|
||
if let Some(reg) = ctx.scopes.symbols.consume_predeclared_slot(name) {
|
||
reg
|
||
} else {
|
||
let var_reg = ctx.alloc_reg();
|
||
ctx.declare(name, var_reg, kind, is_const)?;
|
||
var_reg
|
||
}
|
||
};
|
||
if let Some(&cell_idx) = ctx.captured_bindings.get(name) {
|
||
let op = if fresh_cell { OpCode::MAKE_CELL_FRESH } else { OpCode::MAKE_CELL };
|
||
ctx.inst(Inst::new(op, Operand::Reg(src_reg), Operand::Imm(cell_idx as u16), Operand::None));
|
||
} else if !ctx.with_stack.is_empty() && !ctx.is_with_internal_binding(name) {
|
||
// with 内 var 初始化：对象有该属性则写对象，否则写提升槽（动态解析）。
|
||
// ponytail: with 内顶层 var 不写全局对象属性，with 语句本身已是稀见用例。
|
||
self.emit_with_dynamic_write(name, src_reg, 0, ctx);
|
||
} else {
|
||
// const 声明路径 STORE_VAR 恒 b=0，不查运行时 guard。
|
||
// guard 读 regs[rd] 判断槽是否已初始化，依赖槽初始为 undefined；
|
||
// 声明冗余检查由编译期 declare() 完成（重复声明编译报错），
|
||
// 运行时 guard 只服务"对 const 再赋值"（赋值路径，见 emit_assign_target）。
|
||
ctx.inst(Inst::new(
|
||
OpCode::STORE_VAR,
|
||
Operand::Reg(target_reg),
|
||
Operand::Reg(src_reg),
|
||
Operand::Imm(0),
|
||
));
|
||
}
|
||
ctx.init_var(name);
|
||
// 脚本顶层 var：同步写全局对象，使 globalThis.x 反射声明值。
|
||
if ctx.is_global_scope && matches!(kind, VariableDeclarationKind::Var) {
|
||
self.emit_global_prop_write(name, src_reg, ctx);
|
||
}
|
||
Ok(())
|
||
}
|
||
|
||
pub(crate) fn emit_assign_target(
|
||
&self, target: &AssignmentTarget, src_reg: u32, ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
match target {
|
||
AssignmentTarget::AssignmentTargetIdentifier(id) => {
|
||
let name = id.name.as_str();
|
||
// 解构赋值目标：TDZ 写抛 ReferenceError，const 写抛 TypeError（编译期拦截）。
|
||
self.emit_identifier_tdz_guard(name, ctx)?;
|
||
self.emit_const_write_guard(name, ctx)?;
|
||
let var_reg = ctx.lookup_or_global(name);
|
||
ctx.inst(Inst::new(
|
||
OpCode::STORE_VAR,
|
||
Operand::Reg(var_reg),
|
||
Operand::Reg(src_reg),
|
||
Operand::Imm(if ctx.lookup_const_flag(name) { 1 } else { 0 }),
|
||
));
|
||
Ok(())
|
||
}
|
||
AssignmentTarget::ArrayAssignmentTarget(ap) => self.emit_array_assignment(ap, src_reg, ctx),
|
||
AssignmentTarget::ObjectAssignmentTarget(op) => self.emit_object_assignment(op, src_reg, ctx),
|
||
_ => Err("assignment target not supported".into()),
|
||
}
|
||
}
|
||
|
||
pub(crate) fn emit_binding_pattern(
|
||
&self, pattern: &BindingPattern, src_reg: u32, kind: VariableDeclarationKind, is_const: bool, fresh_cell: bool,
|
||
ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
match pattern {
|
||
BindingPattern::BindingIdentifier(bi) => {
|
||
self.emit_bind_target(bi.name.as_str(), src_reg, kind, is_const, fresh_cell, ctx)
|
||
}
|
||
BindingPattern::ArrayPattern(ap) => self.emit_array_binding(ap, src_reg, kind, is_const, fresh_cell, ctx),
|
||
BindingPattern::ObjectPattern(op) => self.emit_object_binding(op, src_reg, kind, is_const, fresh_cell, ctx),
|
||
BindingPattern::AssignmentPattern(ap) => {
|
||
// `[x = fn]`：默认值函数按绑定名推断 name。
|
||
let name = match &ap.left {
|
||
BindingPattern::BindingIdentifier(bi) => Some(bi.name.as_str()),
|
||
_ => None,
|
||
};
|
||
let val_reg = self.emit_default_if_undefined(src_reg, &ap.right, name, ctx)?;
|
||
self.emit_binding_pattern(&ap.left, val_reg, kind, is_const, fresh_cell, ctx)
|
||
}
|
||
}
|
||
}
|
||
|
||
fn emit_array_binding(
|
||
&self, ap: &ArrayPattern, src_reg: u32, kind: VariableDeclarationKind, is_const: bool, fresh_cell: bool,
|
||
ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_INIT, Operand::None, Operand::Reg(src_reg), Operand::None));
|
||
for elem in &ap.elements {
|
||
let has_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_DONE, Operand::Reg(has_reg), Operand::None, Operand::None));
|
||
let val_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_NEXT, Operand::Reg(val_reg), Operand::None, Operand::None));
|
||
if let Some(pattern) = elem {
|
||
self.emit_binding_pattern(pattern, val_reg, kind, is_const, fresh_cell, ctx)?;
|
||
}
|
||
}
|
||
if let Some(rest) = &ap.rest {
|
||
let rest_reg = self.emit_collect_rest_array(ctx)?;
|
||
self.emit_binding_pattern(&rest.argument, rest_reg, kind, is_const, fresh_cell, ctx)?;
|
||
}
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_CLOSE, Operand::None, Operand::None, Operand::None));
|
||
Ok(())
|
||
}
|
||
|
||
fn emit_collect_rest_array(&self, ctx: &mut CompileCtx) -> Result<u32, String> {
|
||
let rest_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::NEW_ARRAY, Operand::Reg(rest_reg), Operand::None, Operand::None));
|
||
let idx_reg = ctx.alloc_reg();
|
||
let zero_idx = ctx.add_constant(Constant::Int(0));
|
||
ctx.inst(Inst::load_const(Operand::Reg(idx_reg), zero_idx));
|
||
let loop_start = ctx.next_label_id();
|
||
let loop_end = ctx.next_label_id();
|
||
ctx.labels.set_label_pos(loop_start, ctx.insts.len());
|
||
let has_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_DONE, Operand::Reg(has_reg), Operand::None, Operand::None));
|
||
ctx.inst(Inst::jmp_if_false(has_reg, loop_end));
|
||
let val_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_NEXT, Operand::Reg(val_reg), Operand::None, Operand::None));
|
||
ctx.inst(Inst::new(
|
||
OpCode::SET_ELEM,
|
||
Operand::Reg(rest_reg),
|
||
Operand::Reg(idx_reg),
|
||
Operand::Reg(val_reg),
|
||
));
|
||
let tmp_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(
|
||
OpCode::INC_PRE,
|
||
Operand::Reg(idx_reg),
|
||
Operand::Reg(tmp_reg),
|
||
Operand::Reg(tmp_reg),
|
||
));
|
||
ctx.inst(Inst::jmp(loop_start));
|
||
ctx.labels.set_label_pos(loop_end, ctx.insts.len());
|
||
Ok(rest_reg)
|
||
}
|
||
|
||
fn emit_object_binding(
|
||
&self, op: &ObjectPattern, src_reg: u32, kind: VariableDeclarationKind, is_const: bool, fresh_cell: bool,
|
||
ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
// 对象解构先 ToObject(rhs)：null/undefined 抛 TypeError（含空 pattern），
|
||
// 原始值包装为对应对象，保证属性读取与 rest 都以对象为源。
|
||
// 写到临时寄存器，保留 src_reg 原值（声明初始化路径的返回值语义）。
|
||
let obj_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::LOAD_VAR, Operand::Reg(obj_reg), Operand::Reg(src_reg), Operand::None));
|
||
ctx.inst(Inst::new(OpCode::TO_OBJECT, Operand::Reg(obj_reg), Operand::None, Operand::None));
|
||
// 有 rest 时构建运行时 excluded 数组：静态 key 直接 push 常量，computed key 求值结果 push 值。
|
||
let mut excluded = Vec::new();
|
||
let mut excl_arr_reg = None;
|
||
let mut excl_push = 0usize;
|
||
if op.rest.is_some() {
|
||
excl_arr_reg = Some(self.emit_new_excluded_array(ctx));
|
||
}
|
||
for prop in &op.properties {
|
||
let (prop_reg, static_key, key_reg) =
|
||
self.emit_object_property_read_key(obj_reg, &prop.key, prop.computed, ctx)?;
|
||
if let Some(key) = static_key {
|
||
excluded.push(key.clone());
|
||
if let Some(arr) = excl_arr_reg {
|
||
self.emit_push_excluded_key(arr, None, &key, excl_push, ctx);
|
||
excl_push += 1;
|
||
}
|
||
} else if let (Some(arr), Some(key_reg)) = (excl_arr_reg, key_reg) {
|
||
self.emit_push_excluded_key(arr, Some(key_reg), "", excl_push, ctx);
|
||
excl_push += 1;
|
||
}
|
||
self.emit_binding_pattern(&prop.value, prop_reg, kind, is_const, fresh_cell, ctx)?;
|
||
}
|
||
if let Some(rest) = &op.rest {
|
||
let rest_reg = ctx.alloc_reg();
|
||
let excluded_idx = ctx.add_constant(Constant::String(excluded.join("\0")));
|
||
ctx.inst(Inst::rest_object(
|
||
Operand::Reg(rest_reg),
|
||
Operand::Reg(obj_reg),
|
||
excluded_idx as u32,
|
||
excl_arr_reg.map(Operand::Reg),
|
||
));
|
||
self.emit_binding_pattern(&rest.argument, rest_reg, kind, is_const, fresh_cell, ctx)?;
|
||
}
|
||
Ok(())
|
||
}
|
||
|
||
/// 新建运行时 excluded 数组（NEW_ARRAY），供 REST_OBJECT 排除 computed key。
|
||
fn emit_new_excluded_array(&self, ctx: &mut CompileCtx) -> u32 {
|
||
let arr = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::NEW_ARRAY, Operand::Reg(arr), Operand::None, Operand::None));
|
||
arr
|
||
}
|
||
|
||
/// 向 excluded 数组下标 `idx` 写入一个键：`key_val` 为运行时寄存器值，否则用 `key_str` 常量。
|
||
fn emit_push_excluded_key(&self, arr: u32, key_val: Option<u32>, key_str: &str, idx: usize, ctx: &mut CompileCtx) {
|
||
let val_reg = match key_val {
|
||
Some(kv) => kv,
|
||
None => {
|
||
let ki = ctx.add_constant(Constant::String(key_str.to_string()));
|
||
let kr = ctx.alloc_reg();
|
||
ctx.inst(Inst::load_const(Operand::Reg(kr), ki));
|
||
kr
|
||
}
|
||
};
|
||
let elem_idx = ctx.alloc_reg();
|
||
let cidx = ctx.add_constant(Constant::Int(idx as i32));
|
||
ctx.inst(Inst::load_const(Operand::Reg(elem_idx), cidx));
|
||
ctx.inst(Inst::new(
|
||
OpCode::SET_ELEM,
|
||
Operand::Reg(arr),
|
||
Operand::Reg(elem_idx),
|
||
Operand::Reg(val_reg),
|
||
));
|
||
}
|
||
|
||
fn emit_assignment_maybe_default(
|
||
&self, target: &AssignmentTargetMaybeDefault, src_reg: u32, ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
match target {
|
||
AssignmentTargetMaybeDefault::AssignmentTargetWithDefault(default) => {
|
||
let name = match &default.binding {
|
||
AssignmentTarget::AssignmentTargetIdentifier(id) => Some(id.name.as_str()),
|
||
_ => None,
|
||
};
|
||
let val_reg = self.emit_default_if_undefined(src_reg, &default.init, name, ctx)?;
|
||
self.emit_assign_target(&default.binding, val_reg, ctx)
|
||
}
|
||
AssignmentTargetMaybeDefault::ArrayAssignmentTarget(ap) => self.emit_array_assignment(ap, src_reg, ctx),
|
||
AssignmentTargetMaybeDefault::ObjectAssignmentTarget(op) => self.emit_object_assignment(op, src_reg, ctx),
|
||
AssignmentTargetMaybeDefault::AssignmentTargetIdentifier(id) => {
|
||
let name = id.name.as_str();
|
||
// 解构赋值目标：TDZ 写抛 ReferenceError，const 写抛 TypeError（编译期拦截）。
|
||
self.emit_identifier_tdz_guard(name, ctx)?;
|
||
self.emit_const_write_guard(name, ctx)?;
|
||
let var_reg = ctx.lookup_or_global(name);
|
||
ctx.inst(Inst::new(
|
||
OpCode::STORE_VAR,
|
||
Operand::Reg(var_reg),
|
||
Operand::Reg(src_reg),
|
||
Operand::Imm(if ctx.lookup_const_flag(name) { 1 } else { 0 }),
|
||
));
|
||
Ok(())
|
||
}
|
||
_ => Err("assignment target not supported".into()),
|
||
}
|
||
}
|
||
|
||
pub(crate) fn emit_array_assignment(
|
||
&self, ap: &ArrayAssignmentTarget, src_reg: u32, ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_INIT, Operand::None, Operand::Reg(src_reg), Operand::None));
|
||
for elem in &ap.elements {
|
||
let has_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_DONE, Operand::Reg(has_reg), Operand::None, Operand::None));
|
||
let val_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_NEXT, Operand::Reg(val_reg), Operand::None, Operand::None));
|
||
if let Some(target) = elem {
|
||
self.emit_assignment_maybe_default(target, val_reg, ctx)?;
|
||
}
|
||
}
|
||
if let Some(rest) = &ap.rest {
|
||
let rest_reg = self.emit_collect_rest_array(ctx)?;
|
||
self.emit_assign_target(&rest.target, rest_reg, ctx)?;
|
||
}
|
||
ctx.inst(Inst::new(OpCode::FOR_OF_CLOSE, Operand::None, Operand::None, Operand::None));
|
||
Ok(())
|
||
}
|
||
|
||
pub(crate) fn emit_object_assignment(
|
||
&self, op: &ObjectAssignmentTarget, src_reg: u32, ctx: &mut CompileCtx,
|
||
) -> Result<(), String> {
|
||
// 对象解构先 ToObject(rhs)：null/undefined 抛 TypeError（含空 pattern），
|
||
// 原始值包装为对应对象，保证属性读取与 rest 都以对象为源。
|
||
// 写到临时寄存器，保留 src_reg 原值（解构赋值表达式返回值 = rhs）。
|
||
let obj_reg = ctx.alloc_reg();
|
||
ctx.inst(Inst::new(OpCode::LOAD_VAR, Operand::Reg(obj_reg), Operand::Reg(src_reg), Operand::None));
|
||
ctx.inst(Inst::new(OpCode::TO_OBJECT, Operand::Reg(obj_reg), Operand::None, Operand::None));
|
||
let mut excluded = Vec::new();
|
||
let mut excl_arr_reg = None;
|
||
let mut excl_push = 0usize;
|
||
if op.rest.is_some() {
|
||
excl_arr_reg = Some(self.emit_new_excluded_array(ctx));
|
||
}
|
||
for prop in &op.properties {
|
||
match prop {
|
||
AssignmentTargetProperty::AssignmentTargetPropertyIdentifier(id) => {
|
||
let key = id.binding.name.as_str().to_string();
|
||
excluded.push(key.clone());
|
||
if let Some(arr) = excl_arr_reg {
|
||
self.emit_push_excluded_key(arr, None, &key, excl_push, ctx);
|
||
excl_push += 1;
|
||
}
|
||
let mut prop_reg = self.emit_object_property_read(obj_reg, &key, ctx);
|
||
if let Some(default_expr) = &id.init {
|
||
let name = id.binding.name.as_str();
|
||
prop_reg = self.emit_default_if_undefined(prop_reg, default_expr, Some(name), ctx)?;
|
||
}
|
||
let name = id.binding.name.as_str();
|
||
// 解构赋值目标：TDZ 写抛 ReferenceError，const 写抛 TypeError（编译期拦截）。
|
||
self.emit_identifier_tdz_guard(name, ctx)?;
|
||
self.emit_const_write_guard(name, ctx)?;
|
||
let var_reg = ctx.lookup_or_global(name);
|
||
ctx.inst(Inst::new(
|
||
OpCode::STORE_VAR,
|
||
Operand::Reg(var_reg),
|
||
Operand::Reg(prop_reg),
|
||
Operand::Imm(if ctx.lookup_const_flag(name) { 1 } else { 0 }),
|
||
));
|
||
}
|
||
AssignmentTargetProperty::AssignmentTargetPropertyProperty(prop) => {
|
||
let (prop_reg, static_key, key_reg) =
|
||
self.emit_object_property_read_key(obj_reg, &prop.name, prop.computed, ctx)?;
|
||
if let Some(key) = static_key {
|
||
excluded.push(key.clone());
|
||
if let Some(arr) = excl_arr_reg {
|
||
self.emit_push_excluded_key(arr, None, &key, excl_push, ctx);
|
||
excl_push += 1;
|
||
}
|
||
} else if let (Some(arr), Some(key_reg)) = (excl_arr_reg, key_reg) {
|
||
self.emit_push_excluded_key(arr, Some(key_reg), "", excl_push, ctx);
|
||
excl_push += 1;
|
||
}
|
||
self.emit_assignment_maybe_default(&prop.binding, prop_reg, ctx)?;
|
||
}
|
||
}
|
||
}
|
||
if let Some(rest) = &op.rest {
|
||
let rest_reg = ctx.alloc_reg();
|
||
let excluded_idx = ctx.add_constant(Constant::String(excluded.join("\0")));
|
||
ctx.inst(Inst::rest_object(
|
||
Operand::Reg(rest_reg),
|
||
Operand::Reg(obj_reg),
|
||
excluded_idx as u32,
|
||
excl_arr_reg.map(Operand::Reg),
|
||
));
|
||
self.emit_assign_target(&rest.target, rest_reg, ctx)?;
|
||
}
|
||
Ok(())
|
||
}
|
||
}
|