refactor: 捕获扫描器改双引用集引擎单参签名并穷尽匹配

This commit is contained in:
2026-10-12 05:12:35 +00:00
parent e381ad2318
commit a1e00d7bec
5 changed files with 383 additions and 295 deletions
Generated
+20 -20
View File
@@ -1160,7 +1160,7 @@ dependencies = [
[[package]]
name = "oxide_builtins"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"chrono",
"fast-float",
@@ -1185,7 +1185,7 @@ dependencies = [
[[package]]
name = "oxide_bytecode"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"num-bigint",
"oxide_log",
@@ -1193,7 +1193,7 @@ dependencies = [
[[package]]
name = "oxide_cfg"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_emit",
@@ -1204,7 +1204,7 @@ dependencies = [
[[package]]
name = "oxide_cli"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"ansi_term",
"bumpalo",
@@ -1228,7 +1228,7 @@ dependencies = [
[[package]]
name = "oxide_code_cache"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"lru",
"oxide_bytecode",
@@ -1237,7 +1237,7 @@ dependencies = [
[[package]]
name = "oxide_compiler"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_cfg",
@@ -1257,7 +1257,7 @@ dependencies = [
[[package]]
name = "oxide_dce"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_cfg",
@@ -1271,7 +1271,7 @@ dependencies = [
[[package]]
name = "oxide_emit"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"num-bigint",
"oxc_allocator",
@@ -1286,7 +1286,7 @@ dependencies = [
[[package]]
name = "oxide_engine"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_compiler",
@@ -1298,7 +1298,7 @@ dependencies = [
[[package]]
name = "oxide_ir"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_log",
@@ -1307,7 +1307,7 @@ dependencies = [
[[package]]
name = "oxide_kernel"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"bumpalo",
"dashmap",
@@ -1321,7 +1321,7 @@ dependencies = [
[[package]]
name = "oxide_liveness"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_cfg",
@@ -1333,7 +1333,7 @@ dependencies = [
[[package]]
name = "oxide_log"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"tracing",
"tracing-appender",
@@ -1342,11 +1342,11 @@ dependencies = [
[[package]]
name = "oxide_net"
version = "0.16.6"
version = "0.16.7"
[[package]]
name = "oxide_parser"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxc_allocator",
"oxc_ast",
@@ -1361,7 +1361,7 @@ dependencies = [
[[package]]
name = "oxide_regalloc"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_cfg",
@@ -1377,7 +1377,7 @@ dependencies = [
[[package]]
name = "oxide_runtime_api"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"num-bigint",
"num-traits",
@@ -1390,7 +1390,7 @@ dependencies = [
[[package]]
name = "oxide_test262"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"oxide_bytecode",
"oxide_compiler",
@@ -1410,7 +1410,7 @@ dependencies = [
[[package]]
name = "oxide_types"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"bumpalo",
"dashmap",
@@ -1423,7 +1423,7 @@ dependencies = [
[[package]]
name = "oxide_vm"
version = "0.16.6"
version = "0.16.7"
dependencies = [
"bumpalo",
"chrono",
+1 -1
View File
@@ -24,7 +24,7 @@ members = [
]
[workspace.package]
version = "0.16.6"
version = "0.16.7"
edition = "2021"
license = "MIT"
rust-version = "1.80"
+29 -19
View File
@@ -10,7 +10,7 @@ use super::collect_fn_param_names;
use super::names::collect_own_binding_names;
use super::scanner::{
collect_capture_names_expr, collect_capture_names_for_left, collect_capture_names_shadowed,
collect_class_capture_names,
collect_class_capture_names, CaptureEngine,
};
/// 分析本函数:哪些绑定被任意深度嵌套函数捕获 → captured_bindings。
@@ -40,10 +40,10 @@ pub(crate) fn collect_captured_bindings(
pub(crate) fn collect_fn_default_captured(
params: &oxide_parser::FormalParameters, own: &HashSet<String>, out: &mut HashSet<String>,
) {
let empty_shadow = HashSet::new();
for p in &params.items {
if let Some(init) = &p.initializer {
collect_capture_names_expr(init, own, &empty_shadow, out);
let mut eng = CaptureEngine::new(own, HashSet::new(), out);
collect_capture_names_expr(init, &mut eng);
}
// 形参模式的运行时求值表达式(计算键/内嵌默认值)在子作用域求值,
// 其标识符引用须纳入父层 MAKE_CELL 判定。
@@ -57,7 +57,6 @@ pub(crate) fn collect_fn_default_captured(
pub(crate) fn collect_captured_pattern_runtime_exprs(
pattern: &oxide_parser::BindingPattern, own: &HashSet<String>, out: &mut HashSet<String>,
) {
let empty_shadow = HashSet::new();
match pattern {
oxide_parser::BindingPattern::BindingIdentifier(_) => {}
oxide_parser::BindingPattern::ArrayPattern(ap) => {
@@ -71,7 +70,8 @@ pub(crate) fn collect_captured_pattern_runtime_exprs(
oxide_parser::BindingPattern::ObjectPattern(op) => {
for prop in &op.properties {
if prop.computed {
collect_capture_names_expr(prop.key.to_expression(), own, &empty_shadow, out);
let mut eng = CaptureEngine::new(own, HashSet::new(), out);
collect_capture_names_expr(prop.key.to_expression(), &mut eng);
}
collect_captured_pattern_runtime_exprs(&prop.value, own, out);
}
@@ -80,7 +80,8 @@ pub(crate) fn collect_captured_pattern_runtime_exprs(
}
}
oxide_parser::BindingPattern::AssignmentPattern(ap) => {
collect_capture_names_expr(&ap.right, own, &empty_shadow, out);
let mut eng = CaptureEngine::new(own, HashSet::new(), out);
collect_capture_names_expr(&ap.right, &mut eng);
collect_captured_pattern_runtime_exprs(&ap.left, own, out);
}
}
@@ -96,7 +97,8 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
let mut fn_shadow = HashSet::new();
fn_shadow.extend(collect_fn_param_names(&fd.params));
fn_shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, own, &fn_shadow, out);
let mut eng = CaptureEngine::new(own, fn_shadow, out);
collect_capture_names_shadowed(body, &mut eng);
}
Statement::ClassDeclaration(cd) => {
// 类构造器/方法体与字段表达式引用的父级绑定须建 cell,供子模块 upvalue 捕获。
@@ -104,7 +106,8 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, own, &class_shadow, out);
let mut eng = CaptureEngine::new(own, class_shadow, out);
collect_class_capture_names(&cd.body, &mut eng);
}
// export 包裹的变量/函数/类声明:捕获分析须下探声明体,否则被导出函数体内
// 引用模块绑定(含自引用)不会被识别为捕获,闭包内读写退化为隐式全局。
@@ -125,14 +128,16 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
let mut fn_shadow = HashSet::new();
fn_shadow.extend(collect_fn_param_names(&fd.params));
fn_shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, own, &fn_shadow, out);
let mut eng = CaptureEngine::new(own, fn_shadow, out);
collect_capture_names_shadowed(body, &mut eng);
}
Declaration::ClassDeclaration(cd) => {
let mut class_shadow = HashSet::new();
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, own, &class_shadow, out);
let mut eng = CaptureEngine::new(own, class_shadow, out);
collect_class_capture_names(&cd.body, &mut eng);
}
_ => {}
}
@@ -145,14 +150,16 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
let mut fn_shadow = HashSet::new();
fn_shadow.extend(collect_fn_param_names(&fd.params));
fn_shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, own, &fn_shadow, out);
let mut eng = CaptureEngine::new(own, fn_shadow, out);
collect_capture_names_shadowed(body, &mut eng);
}
ExportDefaultDeclarationKind::ClassDeclaration(cd) => {
let mut class_shadow = HashSet::new();
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, own, &class_shadow, out);
let mut eng = CaptureEngine::new(own, class_shadow, out);
collect_class_capture_names(&cd.body, &mut eng);
}
other => {
if let Some(e) = other.as_expression() {
@@ -220,8 +227,8 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
}
} else {
// 赋值头是既有绑定引用:头名与默认值表达式须纳入捕获判定。
let empty_shadow = HashSet::new();
collect_capture_names_for_left(&fi.left, own, &empty_shadow, out);
let mut eng = CaptureEngine::new(own, HashSet::new(), out);
collect_capture_names_for_left(&fi.left, &mut eng);
}
collect_captured_stmt(&fi.body, own, out);
}
@@ -232,8 +239,8 @@ pub(crate) fn collect_captured_stmt(stmt: &Statement, own: &HashSet<String>, out
collect_captured_binding_keys(&d.id, own, out);
}
} else {
let empty_shadow = HashSet::new();
collect_capture_names_for_left(&fo.left, own, &empty_shadow, out);
let mut eng = CaptureEngine::new(own, HashSet::new(), out);
collect_capture_names_for_left(&fo.left, &mut eng);
}
collect_captured_stmt(&fo.body, own, out);
}
@@ -358,13 +365,15 @@ pub(crate) fn collect_captured_expr(expr: &Expression, own: &HashSet<String>, ou
let mut inner = collect_fn_param_names(&fe.params);
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_captured(&fe.params, own, out);
collect_capture_names_shadowed(body, own, &inner, out);
let mut eng = CaptureEngine::new(own, inner, out);
collect_capture_names_shadowed(body, &mut eng);
}
Expression::ArrowFunctionExpression(ae) => {
let mut inner = collect_fn_param_names(&ae.params);
inner.extend(collect_own_binding_names(&[], &ae.body.statements));
collect_fn_default_captured(&ae.params, own, out);
collect_capture_names_shadowed(&ae.body.statements, own, &inner, out);
let mut eng = CaptureEngine::new(own, inner, out);
collect_capture_names_shadowed(&ae.body.statements, &mut eng);
}
Expression::ClassExpression(class) => {
// 类表达式:构造器/方法体与字段表达式引用的父级绑定须建 cell。
@@ -372,7 +381,8 @@ pub(crate) fn collect_captured_expr(expr: &Expression, own: &HashSet<String>, ou
if let Some(id) = &class.id {
class_shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&class.body, own, &class_shadow, out);
let mut eng = CaptureEngine::new(own, class_shadow, out);
collect_class_capture_names(&class.body, &mut eng);
}
Expression::CallExpression(ce) => {
collect_captured_expr(&ce.callee, own, out);
+329 -252
View File
@@ -1,6 +1,6 @@
//! 闭包捕获分析,遮蔽感知引用收集:ref_set × shadow 双集驱动,遍历
//! 语句/表达式/赋值目标/类体 AST,嵌套函数/类/for 头/catch 参数逐层
//! 遮蔽,收集任意深度嵌套函数引用的名字。
//! 闭包捕获分析,遮蔽感知引用收集:`CaptureEngine` 捆绑 ref_set(关注名集)×
//! shadow(遮蔽名集)× out(输出累加器)三集,遍历语句/表达式/赋值目标/类体
//! AST,嵌套函数/类/for 头/catch 参数逐层遮蔽,收集任意深度嵌套函数引用的名字。
use std::collections::HashSet;
@@ -9,139 +9,160 @@ use oxide_parser::{ClassBody, ClassElement, Expression, Statement};
use super::names::collect_own_binding_names;
use super::{collect_fn_param_names, collect_for_left_decl_names};
/// 以 `ref_set`(关注名集)× `shadow`(遮蔽名集)双集驱动,收集被任意深度嵌套
/// 函数引用、且未被遮蔽的名字写入 `out`。本族带显式 `ref_set`/`shadow` 参数,按
/// 过滤条件收集引用名;`captured.rs` 的 `collect_captured_*` 族则以本函数 own 绑定集
/// 为过滤条件做捕获最终判定。
pub(crate) fn collect_capture_names_shadowed(
stmts: &[Statement], ref_set: &HashSet<String>, shadow: &HashSet<String>, out: &mut HashSet<String>,
) {
/// 双引用集引擎:捆绑 ref_set(关注名集)、shadow(遮蔽名集)与 out(输出累加器)
/// 三集,本族十五个收集函数共享单一 `&mut CaptureEngine` 参数。作用域边界(嵌套
/// 函数/类/for 头/catch 参数)对 shadow 集做保存/恢复,逐层遮蔽外层绑定。
pub(crate) struct CaptureEngine<'a> {
/// 关注名集:本次收集哪些名字(不可变)。
ref_set: &'a HashSet<String>,
/// 遮蔽名集:当前作用域内被遮蔽、须排除的名字;作用域边界保存/恢复。
shadow: HashSet<String>,
/// 输出累加器:本次收集到的名字。
out: &'a mut HashSet<String>,
}
impl<'a> CaptureEngine<'a> {
/// 构造引擎:`ref_set` 为关注名集,`shadow` 为初始遮蔽名集,`out` 为输出累加器。
pub(crate) fn new(
ref_set: &'a HashSet<String>, shadow: HashSet<String>, out: &'a mut HashSet<String>,
) -> Self {
CaptureEngine { ref_set, shadow, out }
}
}
/// 以引擎的 ref_set × shadow 双集驱动,收集被任意深度嵌套函数引用、且未被遮蔽的
/// 名字写入 out。本族带显式 ref_set/shadow 语义,按过滤条件收集引用名;`captured.rs`
/// 的 `collect_captured_*` 族则以本函数 own 绑定集为过滤条件做捕获最终判定。
pub(crate) fn collect_capture_names_shadowed(stmts: &[Statement], eng: &mut CaptureEngine) {
for stmt in stmts {
collect_capture_names_stmt(stmt, ref_set, shadow, out);
collect_capture_names_stmt(stmt, eng);
}
}
/// 按语句类型递归扫描引用;进入嵌套函数/类/for 头/catch 时逐层扩充遮蔽集。
pub(crate) fn collect_capture_names_stmt(
stmt: &Statement, ref_set: &HashSet<String>, shadow: &HashSet<String>, out: &mut HashSet<String>,
) {
pub(crate) fn collect_capture_names_stmt(stmt: &Statement, eng: &mut CaptureEngine) {
match stmt {
Statement::ExpressionStatement(es) => collect_capture_names_expr(&es.expression, ref_set, shadow, out),
Statement::ExpressionStatement(es) => collect_capture_names_expr(&es.expression, eng),
Statement::ReturnStatement(rs) => {
if let Some(a) = &rs.argument {
collect_capture_names_expr(a, ref_set, shadow, out);
collect_capture_names_expr(a, eng);
}
}
Statement::VariableDeclaration(vd) => {
for d in &vd.declarations {
// 绑定 pattern 的计算键是运行时求值表达式,其引用须纳入捕获。
collect_capture_names_binding_keys(&d.id, ref_set, shadow, out);
collect_capture_names_binding_keys(&d.id, eng);
if let Some(init) = &d.init {
collect_capture_names_expr(init, ref_set, shadow, out);
collect_capture_names_expr(init, eng);
}
}
}
Statement::FunctionDeclaration(fd) => {
let body: &[Statement] = fd.body.as_ref().map(|b| &b.statements[..]).unwrap_or(&[]);
let mut inner = shadow.clone();
inner.extend(collect_fn_param_names(&fd.params));
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_names(&fd.params, ref_set, shadow, out);
collect_capture_names_shadowed(body, ref_set, &inner, out);
collect_fn_default_names(&fd.params, eng);
// 函数形参与体内声明遮蔽外层绑定:影子集保存/恢复。
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&fd.params));
eng.shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, eng);
eng.shadow = saved;
}
Statement::ClassDeclaration(cd) => {
// 类体(构造器/方法体、字段键与值、静态块)是嵌套作用域:
// 类名遮蔽外层绑定,方法形参与方法体局部进一步遮蔽。
let mut class_shadow = shadow.clone();
let saved = std::mem::take(&mut eng.shadow);
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
eng.shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, ref_set, &class_shadow, out);
collect_class_capture_names(&cd.body, eng);
eng.shadow = saved;
}
Statement::IfStatement(is) => {
collect_capture_names_expr(&is.test, ref_set, shadow, out);
collect_capture_names_stmt(&is.consequent, ref_set, shadow, out);
collect_capture_names_expr(&is.test, eng);
collect_capture_names_stmt(&is.consequent, eng);
if let Some(alt) = &is.alternate {
collect_capture_names_stmt(alt, ref_set, shadow, out);
collect_capture_names_stmt(alt, eng);
}
}
Statement::ForStatement(fs) => {
if let Some(init) = &fs.init {
if let Some(e) = init.as_expression() {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
if let oxide_parser::ForStatementInit::VariableDeclaration(vd) = init {
for d in &vd.declarations {
collect_capture_names_binding_keys(&d.id, ref_set, shadow, out);
collect_capture_names_binding_keys(&d.id, eng);
if let Some(i) = &d.init {
collect_capture_names_expr(i, ref_set, shadow, out);
collect_capture_names_expr(i, eng);
}
}
}
}
if let Some(t) = &fs.test {
collect_capture_names_expr(t, ref_set, shadow, out);
collect_capture_names_expr(t, eng);
}
if let Some(u) = &fs.update {
collect_capture_names_expr(u, ref_set, shadow, out);
collect_capture_names_expr(u, eng);
}
collect_capture_names_stmt(&fs.body, ref_set, shadow, out);
collect_capture_names_stmt(&fs.body, eng);
}
Statement::WhileStatement(w) => {
collect_capture_names_expr(&w.test, ref_set, shadow, out);
collect_capture_names_stmt(&w.body, ref_set, shadow, out);
collect_capture_names_expr(&w.test, eng);
collect_capture_names_stmt(&w.body, eng);
}
Statement::DoWhileStatement(d) => {
collect_capture_names_stmt(&d.body, ref_set, shadow, out);
collect_capture_names_expr(&d.test, ref_set, shadow, out);
collect_capture_names_stmt(&d.body, eng);
collect_capture_names_expr(&d.test, eng);
}
Statement::ForInStatement(fi) => {
collect_capture_names_expr(&fi.right, ref_set, shadow, out);
// left 的 var 声明遮蔽外层同名绑定,body 内引用不视为捕获外层。
let mut for_shadow = shadow.clone();
collect_for_left_decl_names(&fi.left, &mut for_shadow);
collect_capture_names_expr(&fi.right, eng);
// 头的绑定键在头声明名进入影子集之前求值,以当前影子集扫描。
if let oxide_parser::ForStatementLeft::VariableDeclaration(vd) = &fi.left {
for d in &vd.declarations {
collect_capture_names_binding_keys(&d.id, ref_set, shadow, out);
collect_capture_names_binding_keys(&d.id, eng);
}
} else {
// 赋值头是既有绑定引用:头名与默认值表达式须纳入捕获判定。
collect_capture_names_for_left(&fi.left, ref_set, shadow, out);
collect_capture_names_for_left(&fi.left, eng);
}
collect_capture_names_shadowed(std::slice::from_ref(&fi.body), ref_set, &for_shadow, out);
// left 的 var 声明遮蔽外层同名绑定,body 内引用不视为捕获外层。
let saved = std::mem::take(&mut eng.shadow);
collect_for_left_decl_names(&fi.left, &mut eng.shadow);
collect_capture_names_shadowed(std::slice::from_ref(&fi.body), eng);
eng.shadow = saved;
}
Statement::ForOfStatement(fo) => {
collect_capture_names_expr(&fo.right, ref_set, shadow, out);
let mut for_shadow = shadow.clone();
collect_for_left_decl_names(&fo.left, &mut for_shadow);
collect_capture_names_expr(&fo.right, eng);
if let oxide_parser::ForStatementLeft::VariableDeclaration(vd) = &fo.left {
for d in &vd.declarations {
collect_capture_names_binding_keys(&d.id, ref_set, shadow, out);
collect_capture_names_binding_keys(&d.id, eng);
}
} else {
collect_capture_names_for_left(&fo.left, ref_set, shadow, out);
collect_capture_names_for_left(&fo.left, eng);
}
collect_capture_names_shadowed(std::slice::from_ref(&fo.body), ref_set, &for_shadow, out);
let saved = std::mem::take(&mut eng.shadow);
collect_for_left_decl_names(&fo.left, &mut eng.shadow);
collect_capture_names_shadowed(std::slice::from_ref(&fo.body), eng);
eng.shadow = saved;
}
Statement::BlockStatement(b) => collect_capture_names_shadowed(&b.body, ref_set, shadow, out),
Statement::BlockStatement(b) => collect_capture_names_shadowed(&b.body, eng),
Statement::TryStatement(ts) => {
for s in &ts.block.body {
collect_capture_names_stmt(s, ref_set, shadow, out);
collect_capture_names_stmt(s, eng);
}
if let Some(h) = &ts.handler {
// catch 参数解构模式内的表达式引用(默认值等)也会被内部闭包捕获;
// 参数声明名遮蔽 catch 作用域。
let mut catch_shadow = shadow.clone();
// 参数声明名合并进引擎影子集后遮蔽 catch 作用域。
if let Some(param) = &h.param {
collect_capture_names_binding_pattern(&param.pattern, ref_set, shadow, out, &mut catch_shadow);
collect_capture_names_binding_pattern(&param.pattern, eng);
}
for s in &h.body.body {
collect_capture_names_stmt(s, ref_set, &catch_shadow, out);
collect_capture_names_stmt(s, eng);
}
}
if let Some(f) = &ts.finalizer {
for s in &f.body {
collect_capture_names_stmt(s, ref_set, shadow, out);
collect_capture_names_stmt(s, eng);
}
}
}
@@ -150,26 +171,28 @@ pub(crate) fn collect_capture_names_stmt(
match decl {
oxide_parser::Declaration::VariableDeclaration(vd) => {
for d in &vd.declarations {
collect_capture_names_binding_keys(&d.id, ref_set, shadow, out);
collect_capture_names_binding_keys(&d.id, eng);
if let Some(init) = &d.init {
collect_capture_names_expr(init, ref_set, shadow, out);
collect_capture_names_expr(init, eng);
}
}
}
oxide_parser::Declaration::FunctionDeclaration(fd) => {
let body: &[Statement] = fd.body.as_ref().map(|b| &b.statements[..]).unwrap_or(&[]);
let mut inner = shadow.clone();
inner.extend(collect_fn_param_names(&fd.params));
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_names(&fd.params, ref_set, shadow, out);
collect_capture_names_shadowed(body, ref_set, &inner, out);
collect_fn_default_names(&fd.params, eng);
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&fd.params));
eng.shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, eng);
eng.shadow = saved;
}
oxide_parser::Declaration::ClassDeclaration(cd) => {
let mut class_shadow = shadow.clone();
let saved = std::mem::take(&mut eng.shadow);
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
eng.shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, ref_set, &class_shadow, out);
collect_class_capture_names(&cd.body, eng);
eng.shadow = saved;
}
_ => {}
}
@@ -178,107 +201,134 @@ pub(crate) fn collect_capture_names_stmt(
Statement::ExportDefaultDeclaration(exp) => match &exp.declaration {
oxide_parser::ExportDefaultDeclarationKind::FunctionDeclaration(fd) => {
let body: &[Statement] = fd.body.as_ref().map(|b| &b.statements[..]).unwrap_or(&[]);
let mut inner = shadow.clone();
inner.extend(collect_fn_param_names(&fd.params));
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_names(&fd.params, ref_set, shadow, out);
collect_capture_names_shadowed(body, ref_set, &inner, out);
collect_fn_default_names(&fd.params, eng);
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&fd.params));
eng.shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, eng);
eng.shadow = saved;
}
oxide_parser::ExportDefaultDeclarationKind::ClassDeclaration(cd) => {
let mut class_shadow = shadow.clone();
let saved = std::mem::take(&mut eng.shadow);
if let Some(id) = &cd.id {
class_shadow.insert(id.name.as_str().to_string());
eng.shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&cd.body, ref_set, &class_shadow, out);
collect_class_capture_names(&cd.body, eng);
eng.shadow = saved;
}
other => {
if let Some(e) = other.as_expression() {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
}
},
Statement::ThrowStatement(ts) => collect_capture_names_expr(&ts.argument, ref_set, shadow, out),
Statement::ThrowStatement(ts) => collect_capture_names_expr(&ts.argument, eng),
Statement::SwitchStatement(sw) => {
collect_capture_names_expr(&sw.discriminant, ref_set, shadow, out);
collect_capture_names_expr(&sw.discriminant, eng);
for case in &sw.cases {
for s in &case.consequent {
collect_capture_names_stmt(s, ref_set, shadow, out);
collect_capture_names_stmt(s, eng);
}
}
}
Statement::LabeledStatement(ls) => collect_capture_names_stmt(&ls.body, ref_set, shadow, out),
Statement::LabeledStatement(ls) => collect_capture_names_stmt(&ls.body, eng),
Statement::WithStatement(ws) => {
collect_capture_names_expr(&ws.object, ref_set, shadow, out);
collect_capture_names_stmt(&ws.body, ref_set, shadow, out);
collect_capture_names_expr(&ws.object, eng);
collect_capture_names_stmt(&ws.body, eng);
}
_ => {}
// 无扫描需求变体:跳转/调试/空语句、TS 声明、import 与再导出。
Statement::BreakStatement(_) => {}
Statement::ContinueStatement(_) => {}
Statement::DebuggerStatement(_) => {}
Statement::EmptyStatement(_) => {}
Statement::TSTypeAliasDeclaration(_) => {}
Statement::TSInterfaceDeclaration(_) => {}
Statement::TSEnumDeclaration(_) => {}
Statement::TSModuleDeclaration(_) => {}
Statement::TSGlobalDeclaration(_) => {}
Statement::TSImportEqualsDeclaration(_) => {}
Statement::ImportDeclaration(_) => {}
Statement::ExportAllDeclaration(_) => {}
Statement::TSExportAssignment(_) => {}
Statement::TSNamespaceExportDeclaration(_) => {}
}
}
/// 收集类体对 `ref_set` 的引用:方法/构造器体、字段键与值、静态块。
/// 收集类体对 ref_set 的引用:方法/构造器体、字段键与值、静态块。
/// 方法形参与方法体局部声明遮蔽外层绑定(捕获判定用)。
pub(crate) fn collect_class_capture_names(
class_body: &ClassBody, ref_set: &HashSet<String>, class_shadow: &HashSet<String>, out: &mut HashSet<String>,
) {
pub(crate) fn collect_class_capture_names(class_body: &ClassBody, eng: &mut CaptureEngine) {
for element in &class_body.body {
match element {
ClassElement::MethodDefinition(method) => {
let mut inner = class_shadow.clone();
inner.extend(collect_fn_param_names(&method.value.params));
collect_fn_default_names(&method.value.params, eng);
// 方法形参与方法体局部遮蔽外层绑定:影子集保存/恢复。
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&method.value.params));
let body: &[Statement] = method.value.body.as_ref().map(|b| &b.statements[..]).unwrap_or(&[]);
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_names(&method.value.params, ref_set, class_shadow, out);
collect_capture_names_shadowed(body, ref_set, &inner, out);
eng.shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, eng);
eng.shadow = saved;
}
ClassElement::PropertyDefinition(prop) => {
if let Some(expr) = prop.key.as_expression() {
collect_capture_names_expr(expr, ref_set, class_shadow, out);
collect_capture_names_expr(expr, eng);
}
if let Some(value) = &prop.value {
collect_capture_names_expr(value, ref_set, class_shadow, out);
collect_capture_names_expr(value, eng);
}
}
ClassElement::StaticBlock(block) => {
collect_capture_names_shadowed(&block.body, ref_set, class_shadow, out);
collect_capture_names_shadowed(&block.body, eng);
}
_ => {}
// 无扫描需求变体:访问器属性与 TS 索引签名。
ClassElement::AccessorProperty(_) => {}
ClassElement::TSIndexSignature(_) => {}
}
}
}
/// 遍历 catch 参数解构模式:收集模式内表达式引用(默认值等),声明名写入
/// `catch_shadow` 遮蔽 catch 作用域。
/// 遍历 catch 参数解构模式:收集模式内表达式引用(默认值等),声明名合并进引擎
/// 影子集遮蔽 catch 作用域。模式内表达式扫描走外层影子集,不受本模式声明名影响。
pub(crate) fn collect_capture_names_binding_pattern(
pattern: &oxide_parser::BindingPattern, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>, catch_shadow: &mut HashSet<String>,
pattern: &oxide_parser::BindingPattern, eng: &mut CaptureEngine,
) {
let mut declared = HashSet::new();
collect_binding_pattern_refs(pattern, eng, &mut declared);
eng.shadow.extend(declared);
}
/// 递归遍历 catch 参数解构模式:收集模式内表达式引用(默认值等)写入引擎输出,
/// 声明名累积进 `declared` 供调用方合并进影子集。
fn collect_binding_pattern_refs(
pattern: &oxide_parser::BindingPattern, eng: &mut CaptureEngine, declared: &mut HashSet<String>,
) {
match pattern {
oxide_parser::BindingPattern::BindingIdentifier(bi) => {
catch_shadow.insert(bi.name.as_str().to_string());
declared.insert(bi.name.as_str().to_string());
}
oxide_parser::BindingPattern::ArrayPattern(ap) => {
for p in ap.elements.iter().flatten() {
collect_capture_names_binding_pattern(p, ref_set, shadow, out, catch_shadow);
collect_binding_pattern_refs(p, eng, declared);
}
if let Some(rest) = &ap.rest {
collect_capture_names_binding_pattern(&rest.argument, ref_set, shadow, out, catch_shadow);
collect_binding_pattern_refs(&rest.argument, eng, declared);
}
}
oxide_parser::BindingPattern::ObjectPattern(op) => {
for prop in &op.properties {
// 计算键是运行时求值表达式,其引用须纳入捕获。
if prop.computed {
collect_capture_names_expr(prop.key.to_expression(), ref_set, shadow, out);
collect_capture_names_expr(prop.key.to_expression(), eng);
}
collect_capture_names_binding_pattern(&prop.value, ref_set, shadow, out, catch_shadow);
collect_binding_pattern_refs(&prop.value, eng, declared);
}
if let Some(rest) = &op.rest {
collect_capture_names_binding_pattern(&rest.argument, ref_set, shadow, out, catch_shadow);
collect_binding_pattern_refs(&rest.argument, eng, declared);
}
}
oxide_parser::BindingPattern::AssignmentPattern(ap) => {
collect_capture_names_expr(&ap.right, ref_set, shadow, out);
collect_capture_names_binding_pattern(&ap.left, ref_set, shadow, out, catch_shadow);
collect_capture_names_expr(&ap.right, eng);
collect_binding_pattern_refs(&ap.left, eng, declared);
}
}
}
@@ -287,314 +337,325 @@ pub(crate) fn collect_capture_names_binding_pattern(
/// 默认值(`{a = x}` 的 x)都是模式内求值的表达式,嵌套函数引用外层绑定时须
/// 纳入捕获(与赋值侧/对象字面量/类字段键遍历同口径)。
pub(crate) fn collect_capture_names_binding_keys(
pattern: &oxide_parser::BindingPattern, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
pattern: &oxide_parser::BindingPattern, eng: &mut CaptureEngine,
) {
match pattern {
oxide_parser::BindingPattern::BindingIdentifier(_) => {}
oxide_parser::BindingPattern::ArrayPattern(ap) => {
for p in ap.elements.iter().flatten() {
collect_capture_names_binding_keys(p, ref_set, shadow, out);
collect_capture_names_binding_keys(p, eng);
}
if let Some(rest) = &ap.rest {
collect_capture_names_binding_keys(&rest.argument, ref_set, shadow, out);
collect_capture_names_binding_keys(&rest.argument, eng);
}
}
oxide_parser::BindingPattern::ObjectPattern(op) => {
for prop in &op.properties {
if prop.computed {
collect_capture_names_expr(prop.key.to_expression(), ref_set, shadow, out);
collect_capture_names_expr(prop.key.to_expression(), eng);
}
collect_capture_names_binding_keys(&prop.value, ref_set, shadow, out);
collect_capture_names_binding_keys(&prop.value, eng);
}
if let Some(rest) = &op.rest {
collect_capture_names_binding_keys(&rest.argument, ref_set, shadow, out);
collect_capture_names_binding_keys(&rest.argument, eng);
}
}
oxide_parser::BindingPattern::AssignmentPattern(ap) => {
// 内嵌默认值表达式引用外层绑定须捕获(与 binding_pattern/赋值侧
// maybe_default 的 init 扫描同口径);left 继续递归模式键。
collect_capture_names_expr(&ap.right, ref_set, shadow, out);
collect_capture_names_binding_keys(&ap.left, ref_set, shadow, out);
collect_capture_names_expr(&ap.right, eng);
collect_capture_names_binding_keys(&ap.left, eng);
}
}
}
/// 扫描赋值目标中的引用(标识符写名,成员目标扫对象/键,解构目标递归元素)。
pub(crate) fn collect_capture_names_assign_target(
target: &oxide_parser::AssignmentTarget, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
target: &oxide_parser::AssignmentTarget, eng: &mut CaptureEngine,
) {
match target {
oxide_parser::AssignmentTarget::AssignmentTargetIdentifier(ati) => {
let name = ati.name.as_str();
if ref_set.contains(name) && !shadow.contains(name) {
out.insert(ati.name.to_string());
if eng.ref_set.contains(name) && !eng.shadow.contains(name) {
eng.out.insert(ati.name.to_string());
}
}
oxide_parser::AssignmentTarget::StaticMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
}
oxide_parser::AssignmentTarget::ComputedMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.expression, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
collect_capture_names_expr(&m.expression, eng);
}
oxide_parser::AssignmentTarget::ArrayAssignmentTarget(a) => {
collect_capture_names_array_target(a, ref_set, shadow, out);
collect_capture_names_array_target(a, eng);
}
oxide_parser::AssignmentTarget::ObjectAssignmentTarget(o) => {
collect_capture_names_object_target(o, ref_set, shadow, out);
collect_capture_names_object_target(o, eng);
}
_ => {}
// 无扫描需求变体:私有字段目标与 TS 类型断言目标。
oxide_parser::AssignmentTarget::PrivateFieldExpression(_) => {}
oxide_parser::AssignmentTarget::TSAsExpression(_) => {}
oxide_parser::AssignmentTarget::TSSatisfiesExpression(_) => {}
oxide_parser::AssignmentTarget::TSNonNullExpression(_) => {}
oxide_parser::AssignmentTarget::TSTypeAssertion(_) => {}
}
}
/// 数组赋值目标:元素递归(含默认值),rest 目标递归。
fn collect_capture_names_array_target(
a: &oxide_parser::ArrayAssignmentTarget, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
) {
fn collect_capture_names_array_target(a: &oxide_parser::ArrayAssignmentTarget, eng: &mut CaptureEngine) {
for e in a.elements.iter().flatten() {
collect_capture_names_maybe_default_target(e, ref_set, shadow, out);
collect_capture_names_maybe_default_target(e, eng);
}
if let Some(rest) = &a.rest {
collect_capture_names_assign_target(&rest.target, ref_set, shadow, out);
collect_capture_names_assign_target(&rest.target, eng);
}
}
/// 对象赋值目标:属性标识符写名/默认值/计算键,rest 目标递归。
fn collect_capture_names_object_target(
o: &oxide_parser::ObjectAssignmentTarget, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
) {
fn collect_capture_names_object_target(o: &oxide_parser::ObjectAssignmentTarget, eng: &mut CaptureEngine) {
for prop in &o.properties {
if let oxide_parser::AssignmentTargetProperty::AssignmentTargetPropertyIdentifier(id) = prop {
if ref_set.contains(id.binding.name.as_str()) && !shadow.contains(id.binding.name.as_str()) {
out.insert(id.binding.name.to_string());
if eng.ref_set.contains(id.binding.name.as_str()) && !eng.shadow.contains(id.binding.name.as_str()) {
eng.out.insert(id.binding.name.to_string());
}
if let Some(init) = &id.init {
collect_capture_names_expr(init, ref_set, shadow, out);
collect_capture_names_expr(init, eng);
}
} else if let oxide_parser::AssignmentTargetProperty::AssignmentTargetPropertyProperty(p) = prop {
if let Some(name_expr) = p.name.as_expression() {
collect_capture_names_expr(name_expr, ref_set, shadow, out);
collect_capture_names_expr(name_expr, eng);
}
collect_capture_names_maybe_default_target(&p.binding, ref_set, shadow, out);
collect_capture_names_maybe_default_target(&p.binding, eng);
}
}
if let Some(rest) = &o.rest {
collect_capture_names_assign_target(&rest.target, ref_set, shadow, out);
collect_capture_names_assign_target(&rest.target, eng);
}
}
/// 扫描 for-in/for-of 赋值头:标识符写名、数组/对象解构元素(含默认值)与 rest。
/// 声明头是新绑定无引用语义,不扫。
pub(crate) fn collect_capture_names_for_left(
left: &oxide_parser::ForStatementLeft, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
) {
pub(crate) fn collect_capture_names_for_left(left: &oxide_parser::ForStatementLeft, eng: &mut CaptureEngine) {
match left {
oxide_parser::ForStatementLeft::AssignmentTargetIdentifier(id) => {
let name = id.name.as_str();
if ref_set.contains(name) && !shadow.contains(name) {
out.insert(name.to_string());
if eng.ref_set.contains(name) && !eng.shadow.contains(name) {
eng.out.insert(name.to_string());
}
}
oxide_parser::ForStatementLeft::ArrayAssignmentTarget(a) => {
collect_capture_names_array_target(a, ref_set, shadow, out);
collect_capture_names_array_target(a, eng);
}
oxide_parser::ForStatementLeft::ObjectAssignmentTarget(o) => {
collect_capture_names_object_target(o, ref_set, shadow, out);
collect_capture_names_object_target(o, eng);
}
_ => {}
// 无扫描需求变体:声明头是新绑定无引用语义,成员与 TS 类型断言目标不扫。
oxide_parser::ForStatementLeft::VariableDeclaration(_) => {}
oxide_parser::ForStatementLeft::StaticMemberExpression(_) => {}
oxide_parser::ForStatementLeft::ComputedMemberExpression(_) => {}
oxide_parser::ForStatementLeft::PrivateFieldExpression(_) => {}
oxide_parser::ForStatementLeft::TSAsExpression(_) => {}
oxide_parser::ForStatementLeft::TSSatisfiesExpression(_) => {}
oxide_parser::ForStatementLeft::TSNonNullExpression(_) => {}
oxide_parser::ForStatementLeft::TSTypeAssertion(_) => {}
}
}
/// 解构赋值元素可能是 `AssignmentTarget` 或带默认值的包装(后者多一层 `init`)。
pub(crate) fn collect_capture_names_maybe_default_target(
target: &oxide_parser::AssignmentTargetMaybeDefault, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
target: &oxide_parser::AssignmentTargetMaybeDefault, eng: &mut CaptureEngine,
) {
use oxide_parser::AssignmentTargetMaybeDefault as MaybeDefault;
match target {
MaybeDefault::AssignmentTargetWithDefault(d) => {
collect_capture_names_expr(&d.init, ref_set, shadow, out);
collect_capture_names_assign_target(&d.binding, ref_set, shadow, out);
collect_capture_names_expr(&d.init, eng);
collect_capture_names_assign_target(&d.binding, eng);
}
MaybeDefault::AssignmentTargetIdentifier(ati) => {
let name = ati.name.as_str();
if ref_set.contains(name) && !shadow.contains(name) {
out.insert(ati.name.to_string());
if eng.ref_set.contains(name) && !eng.shadow.contains(name) {
eng.out.insert(ati.name.to_string());
}
}
MaybeDefault::StaticMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
}
MaybeDefault::ComputedMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.expression, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
collect_capture_names_expr(&m.expression, eng);
}
MaybeDefault::ArrayAssignmentTarget(a) => {
for e in a.elements.iter().flatten() {
collect_capture_names_maybe_default_target(e, ref_set, shadow, out);
collect_capture_names_maybe_default_target(e, eng);
}
}
MaybeDefault::ObjectAssignmentTarget(o) => {
for prop in &o.properties {
if let oxide_parser::AssignmentTargetProperty::AssignmentTargetPropertyIdentifier(id) = prop {
if ref_set.contains(id.binding.name.as_str()) && !shadow.contains(id.binding.name.as_str()) {
out.insert(id.binding.name.to_string());
if eng.ref_set.contains(id.binding.name.as_str()) && !eng.shadow.contains(id.binding.name.as_str()) {
eng.out.insert(id.binding.name.to_string());
}
if let Some(init) = &id.init {
collect_capture_names_expr(init, ref_set, shadow, out);
collect_capture_names_expr(init, eng);
}
} else if let oxide_parser::AssignmentTargetProperty::AssignmentTargetPropertyProperty(p) = prop {
if let Some(name_expr) = p.name.as_expression() {
collect_capture_names_expr(name_expr, ref_set, shadow, out);
collect_capture_names_expr(name_expr, eng);
}
collect_capture_names_maybe_default_target(&p.binding, ref_set, shadow, out);
collect_capture_names_maybe_default_target(&p.binding, eng);
}
}
}
_ => {}
// 无扫描需求变体:私有字段目标与 TS 类型断言目标。
MaybeDefault::PrivateFieldExpression(_) => {}
MaybeDefault::TSAsExpression(_) => {}
MaybeDefault::TSSatisfiesExpression(_) => {}
MaybeDefault::TSNonNullExpression(_) => {}
MaybeDefault::TSTypeAssertion(_) => {}
}
}
/// 扫描一元更新目标(`++x` / `obj.x++`)中的引用。
pub(crate) fn collect_capture_names_simple_target(
target: &oxide_parser::SimpleAssignmentTarget, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
target: &oxide_parser::SimpleAssignmentTarget, eng: &mut CaptureEngine,
) {
match target {
oxide_parser::SimpleAssignmentTarget::AssignmentTargetIdentifier(ati) => {
let name = ati.name.as_str();
if ref_set.contains(name) && !shadow.contains(name) {
out.insert(ati.name.to_string());
if eng.ref_set.contains(name) && !eng.shadow.contains(name) {
eng.out.insert(ati.name.to_string());
}
}
oxide_parser::SimpleAssignmentTarget::StaticMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
}
oxide_parser::SimpleAssignmentTarget::ComputedMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.expression, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
collect_capture_names_expr(&m.expression, eng);
}
_ => {}
// 无扫描需求变体:私有字段目标与 TS 类型断言目标。
oxide_parser::SimpleAssignmentTarget::PrivateFieldExpression(_) => {}
oxide_parser::SimpleAssignmentTarget::TSAsExpression(_) => {}
oxide_parser::SimpleAssignmentTarget::TSSatisfiesExpression(_) => {}
oxide_parser::SimpleAssignmentTarget::TSNonNullExpression(_) => {}
oxide_parser::SimpleAssignmentTarget::TSTypeAssertion(_) => {}
}
}
/// 收集函数参数默认值表达式里的引用(子层 upvalue 判定;参数名遮蔽)。
pub(crate) fn collect_fn_default_names(
params: &oxide_parser::FormalParameters, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
) {
pub(crate) fn collect_fn_default_names(params: &oxide_parser::FormalParameters, eng: &mut CaptureEngine) {
for p in &params.items {
if let Some(init) = &p.initializer {
collect_capture_names_expr(init, ref_set, shadow, out);
collect_capture_names_expr(init, eng);
}
let mut param_shadow = shadow.clone();
collect_capture_names_binding_pattern(&p.pattern, ref_set, shadow, out, &mut param_shadow);
// 形参模式声明名只遮蔽本形参模式,不渗入后续形参默认值扫描。
let saved = std::mem::take(&mut eng.shadow);
collect_capture_names_binding_pattern(&p.pattern, eng);
eng.shadow = saved;
}
}
/// 按表达式类型递归扫描引用;进入嵌套函数体时以形参 + 体内声明扩充遮蔽集。与
/// `captured.rs` 的 `collect_captured_expr` 相比,本函数带显式 `ref_set`/`shadow`
/// `captured.rs` 的 `collect_captured_expr` 相比,本函数经引擎的 ref_set/shadow
/// 收集引用名,不做捕获最终判定。
pub(crate) fn collect_capture_names_expr(
expr: &Expression, ref_set: &HashSet<String>, shadow: &HashSet<String>, out: &mut HashSet<String>,
) {
pub(crate) fn collect_capture_names_expr(expr: &Expression, eng: &mut CaptureEngine) {
match expr {
Expression::Identifier(id) => {
let name = id.name.as_str();
if ref_set.contains(name) && !shadow.contains(name) {
out.insert(id.name.to_string());
if eng.ref_set.contains(name) && !eng.shadow.contains(name) {
eng.out.insert(id.name.to_string());
}
}
Expression::AssignmentExpression(ae) => {
// 赋值目标里的引用也须捕获:标识符目标写名,成员/解构目标扫描其对象/元素。
collect_capture_names_assign_target(&ae.left, ref_set, shadow, out);
collect_capture_names_expr(&ae.right, ref_set, shadow, out);
collect_capture_names_assign_target(&ae.left, eng);
collect_capture_names_expr(&ae.right, eng);
}
Expression::UpdateExpression(ue) => {
collect_capture_names_simple_target(&ue.argument, ref_set, shadow, out);
collect_capture_names_simple_target(&ue.argument, eng);
}
Expression::FunctionExpression(fe) => {
let body: &[Statement] = fe.body.as_ref().map(|b| &b.statements[..]).unwrap_or(&[]);
let mut inner = shadow.clone();
inner.extend(collect_fn_param_names(&fe.params));
inner.extend(collect_own_binding_names(&[], body));
collect_fn_default_names(&fe.params, ref_set, shadow, out);
collect_capture_names_shadowed(body, ref_set, &inner, out);
collect_fn_default_names(&fe.params, eng);
// 函数形参与体内声明遮蔽外层绑定:影子集保存/恢复。
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&fe.params));
eng.shadow.extend(collect_own_binding_names(&[], body));
collect_capture_names_shadowed(body, eng);
eng.shadow = saved;
}
Expression::ArrowFunctionExpression(ae) => {
let mut inner = shadow.clone();
inner.extend(collect_fn_param_names(&ae.params));
inner.extend(collect_own_binding_names(&[], &ae.body.statements));
collect_fn_default_names(&ae.params, ref_set, shadow, out);
collect_capture_names_shadowed(&ae.body.statements, ref_set, &inner, out);
collect_fn_default_names(&ae.params, eng);
let saved = std::mem::take(&mut eng.shadow);
eng.shadow.extend(collect_fn_param_names(&ae.params));
eng.shadow.extend(collect_own_binding_names(&[], &ae.body.statements));
collect_capture_names_shadowed(&ae.body.statements, eng);
eng.shadow = saved;
}
Expression::ClassExpression(class) => {
// 类表达式:方法/构造器体与字段表达式是嵌套作用域,引用须捕获。
let mut class_shadow = shadow.clone();
let saved = std::mem::take(&mut eng.shadow);
if let Some(id) = &class.id {
class_shadow.insert(id.name.as_str().to_string());
eng.shadow.insert(id.name.as_str().to_string());
}
collect_class_capture_names(&class.body, ref_set, &class_shadow, out);
collect_class_capture_names(&class.body, eng);
eng.shadow = saved;
}
Expression::BinaryExpression(be) => {
collect_capture_names_expr(&be.left, ref_set, shadow, out);
collect_capture_names_expr(&be.right, ref_set, shadow, out);
collect_capture_names_expr(&be.left, eng);
collect_capture_names_expr(&be.right, eng);
}
Expression::UnaryExpression(ue) => collect_capture_names_expr(&ue.argument, ref_set, shadow, out),
Expression::UnaryExpression(ue) => collect_capture_names_expr(&ue.argument, eng),
Expression::CallExpression(ce) => {
collect_capture_names_expr(&ce.callee, ref_set, shadow, out);
collect_capture_names_expr(&ce.callee, eng);
for a in &ce.arguments {
collect_capture_names_arg(a, ref_set, shadow, out);
collect_capture_names_arg(a, eng);
}
}
Expression::NewExpression(ne) => {
collect_capture_names_expr(&ne.callee, ref_set, shadow, out);
collect_capture_names_expr(&ne.callee, eng);
for a in &ne.arguments {
collect_capture_names_arg(a, ref_set, shadow, out);
collect_capture_names_arg(a, eng);
}
}
Expression::SequenceExpression(se) => {
for e in &se.expressions {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
}
Expression::ConditionalExpression(ce) => {
collect_capture_names_expr(&ce.test, ref_set, shadow, out);
collect_capture_names_expr(&ce.consequent, ref_set, shadow, out);
collect_capture_names_expr(&ce.alternate, ref_set, shadow, out);
collect_capture_names_expr(&ce.test, eng);
collect_capture_names_expr(&ce.consequent, eng);
collect_capture_names_expr(&ce.alternate, eng);
}
Expression::ArrayExpression(ae) => {
for e in &ae.elements {
if let Some(e) = e.as_expression() {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
}
}
Expression::LogicalExpression(le) => {
collect_capture_names_expr(&le.left, ref_set, shadow, out);
collect_capture_names_expr(&le.right, ref_set, shadow, out);
collect_capture_names_expr(&le.left, eng);
collect_capture_names_expr(&le.right, eng);
}
Expression::ComputedMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.expression, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
collect_capture_names_expr(&m.expression, eng);
}
Expression::StaticMemberExpression(m) => collect_capture_names_expr(&m.object, ref_set, shadow, out),
Expression::PrivateFieldExpression(m) => collect_capture_names_expr(&m.object, ref_set, shadow, out),
Expression::ParenthesizedExpression(p) => collect_capture_names_expr(&p.expression, ref_set, shadow, out),
Expression::StaticMemberExpression(m) => collect_capture_names_expr(&m.object, eng),
Expression::PrivateFieldExpression(m) => collect_capture_names_expr(&m.object, eng),
Expression::ParenthesizedExpression(p) => collect_capture_names_expr(&p.expression, eng),
Expression::TemplateLiteral(tl) => {
for e in &tl.expressions {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
}
Expression::TaggedTemplateExpression(tt) => {
collect_capture_names_expr(&tt.tag, ref_set, shadow, out);
collect_capture_names_expr(&tt.tag, eng);
for e in &tt.quasi.expressions {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
}
}
Expression::ObjectExpression(o) => {
@@ -602,12 +663,12 @@ pub(crate) fn collect_capture_names_expr(
match prop {
oxide_parser::ObjectPropertyKind::ObjectProperty(p) => {
if p.computed {
collect_capture_names_expr(p.key.to_expression(), ref_set, shadow, out);
collect_capture_names_expr(p.key.to_expression(), eng);
}
collect_capture_names_expr(&p.value, ref_set, shadow, out);
collect_capture_names_expr(&p.value, eng);
}
oxide_parser::ObjectPropertyKind::SpreadProperty(spread) => {
collect_capture_names_expr(&spread.argument, ref_set, shadow, out);
collect_capture_names_expr(&spread.argument, eng);
}
}
}
@@ -616,52 +677,68 @@ pub(crate) fn collect_capture_names_expr(
// LOAD_VAR 读调用方寄存器残留(挂起恢复后寄存器已被覆盖)。
Expression::YieldExpression(ye) => {
if let Some(a) = &ye.argument {
collect_capture_names_expr(a, ref_set, shadow, out);
collect_capture_names_expr(a, eng);
}
}
// await 表达式:被等待的值里引用的父变量须纳入捕获(与 yield 同因——
// 异步体挂起恢复后寄存器已被覆盖,只能经 cell 读取)。
Expression::AwaitExpression(ae) => {
collect_capture_names_expr(&ae.argument, ref_set, shadow, out);
collect_capture_names_expr(&ae.argument, eng);
}
Expression::ChainExpression(c) => collect_capture_names_chain(&c.expression, ref_set, shadow, out),
_ => {}
Expression::ChainExpression(c) => collect_capture_names_chain(&c.expression, eng),
// 无扫描需求变体:字面量、this/super/meta、import 表达式、
// 私有 in 表达式、JSX 与 TS 类型断言族。
Expression::BooleanLiteral(_) => {}
Expression::NullLiteral(_) => {}
Expression::NumericLiteral(_) => {}
Expression::BigIntLiteral(_) => {}
Expression::RegExpLiteral(_) => {}
Expression::StringLiteral(_) => {}
Expression::MetaProperty(_) => {}
Expression::Super(_) => {}
Expression::ImportExpression(_) => {}
Expression::ThisExpression(_) => {}
Expression::PrivateInExpression(_) => {}
Expression::JSXElement(_) => {}
Expression::JSXFragment(_) => {}
Expression::TSAsExpression(_) => {}
Expression::TSSatisfiesExpression(_) => {}
Expression::TSTypeAssertion(_) => {}
Expression::TSNonNullExpression(_) => {}
Expression::TSInstantiationExpression(_) => {}
Expression::V8IntrinsicExpression(_) => {}
}
}
/// 遍历可选链元素,扫描链上成员访问、调用与实参中的引用。
pub(crate) fn collect_capture_names_chain(
element: &oxide_parser::ChainElement, ref_set: &HashSet<String>, shadow: &HashSet<String>,
out: &mut HashSet<String>,
) {
pub(crate) fn collect_capture_names_chain(element: &oxide_parser::ChainElement, eng: &mut CaptureEngine) {
match element {
oxide_parser::ChainElement::StaticMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
}
oxide_parser::ChainElement::ComputedMemberExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.expression, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
collect_capture_names_expr(&m.expression, eng);
}
oxide_parser::ChainElement::PrivateFieldExpression(m) => {
collect_capture_names_expr(&m.object, ref_set, shadow, out);
collect_capture_names_expr(&m.object, eng);
}
oxide_parser::ChainElement::CallExpression(call) => {
collect_capture_names_expr(&call.callee, ref_set, shadow, out);
collect_capture_names_expr(&call.callee, eng);
for a in &call.arguments {
collect_capture_names_arg(a, ref_set, shadow, out);
collect_capture_names_arg(a, eng);
}
}
_ => {}
// 无扫描需求变体:TS 非空断言链元素。
oxide_parser::ChainElement::TSNonNullExpression(_) => {}
}
}
/// 遍历调用实参:静态实参与 spread 内部表达式都纳入捕获扫描。
pub(crate) fn collect_capture_names_arg(
arg: &oxide_parser::Argument, ref_set: &HashSet<String>, shadow: &HashSet<String>, out: &mut HashSet<String>,
) {
pub(crate) fn collect_capture_names_arg(arg: &oxide_parser::Argument, eng: &mut CaptureEngine) {
if let Some(e) = arg.as_expression() {
collect_capture_names_expr(e, ref_set, shadow, out);
collect_capture_names_expr(e, eng);
} else if let oxide_parser::Argument::SpreadElement(sp) = arg {
collect_capture_names_expr(&sp.argument, ref_set, shadow, out);
collect_capture_names_expr(&sp.argument, eng);
}
}
+4 -3
View File
@@ -7,7 +7,7 @@ use std::collections::{BTreeMap, HashSet};
use oxide_bytecode::module::UpvalueCapture;
use oxide_parser::Statement;
use super::scanner::{collect_capture_names_expr, collect_capture_names_shadowed};
use super::scanner::{collect_capture_names_expr, collect_capture_names_shadowed, CaptureEngine};
/// 分析子函数 body:引用父级被捕获绑定的名字 → upvalue_captures。
/// 名字若在父 `captured_bindings`(父 own cell)则 `cell_idx` 索引定义方表;
@@ -22,10 +22,11 @@ pub(crate) fn collect_upvalue_names(
parent_names.insert(u.name.clone());
}
let mut names = HashSet::new();
collect_capture_names_shadowed(body_stmts, &parent_names, sub_own, &mut names);
let mut eng = CaptureEngine::new(&parent_names, sub_own.clone(), &mut names);
collect_capture_names_shadowed(body_stmts, &mut eng);
// 参数默认值表达式(不在 body_stmts)里的嵌套函数引用也会捕获父变量。
for expr in extra_exprs {
collect_capture_names_expr(expr, &parent_names, sub_own, &mut names);
collect_capture_names_expr(expr, &mut eng);
}
// HashSet 迭代序带随机种子(进程级非确定),必须排序使 upvalue_captures 的顺序与
// 父 captured_bindings 的 cell_idx(BTreeMap 名字序)对齐——否则 LOAD_UPVALUE 的