mirror of
https://github.com/pjh456/OxideJS.git
synced 2026-10-24 18:51:13 +08:00
84 lines
3.7 KiB
Rust
84 lines
3.7 KiB
Rust
//! emit：AST → IR 代码生成（parse → IR → bytecode 中段）。
|
||
//!
|
||
//! `Emitter` 提供各语法域的 emit_* 方法；核心状态集中在 `CompileCtx`
|
||
//! （见 `compile_ctx.rs`）。产出分域组合的 `IRFunction`，由
|
||
//! `oxide_ir::lower` 降为 bytecode。
|
||
|
||
/// 是否为匿名函数定义（剥括号）：函数/箭头/class 表达式。
|
||
pub fn is_anonymous_function_definition(expr: &oxide_parser::Expression) -> bool {
|
||
match expr {
|
||
oxide_parser::Expression::ArrowFunctionExpression(_)
|
||
| oxide_parser::Expression::FunctionExpression(_)
|
||
| oxide_parser::Expression::ClassExpression(_) => true,
|
||
oxide_parser::Expression::ParenthesizedExpression(p) => is_anonymous_function_definition(&p.expression),
|
||
_ => false,
|
||
}
|
||
}
|
||
|
||
/// 常量池项（bytecode module 类型）re-export，供调用方构造常量。
|
||
pub use oxide_bytecode::module::Constant;
|
||
/// 变量声明种类（var/let/const），re-export 自 parser。
|
||
pub use oxide_parser::VariableDeclarationKind;
|
||
/// AST 语法树节点与运算符类型，re-export 自 parser。
|
||
pub use oxide_parser::{AssignmentOperator, BinaryOperator, Expression, Statement, UnaryOperator};
|
||
|
||
/// 编译入口。方法按语法域组织在 `impl Emitter` 中。
|
||
pub struct Emitter {
|
||
/// 源码是否为 `oxide_kernel::string_forge::source_escape` 产物
|
||
/// （eval/Function 动态编译）：源文本内的孤立 surrogate 单元 / FFFD 以
|
||
/// `\uXXXX` 转义文本承载（oxc 不可见裸单元——Rust str 无孤立 surrogate，
|
||
/// 转义文本是唯一注入形态），反斜杠原样透传。正则字面量的源文本切片据此
|
||
/// 经 `source_escape_to_key` 还原池键 marker 形态入池（物化时
|
||
/// `decode_key` 还原为原始单元，`.source` 按原始源返回）；静态源切片不含
|
||
/// 注入 marker，走 `pool_key_plain`。
|
||
pub(crate) source_encoded: bool,
|
||
}
|
||
|
||
/// 判断 f64 是否为整数值且在 i32 范围内（整数常量编码用）。
|
||
pub fn is_int_literal(value: f64) -> bool {
|
||
value.fract() == 0.0 && value >= i32::MIN as f64 && value <= i32::MAX as f64
|
||
}
|
||
|
||
/// 判断表达式是否无副作用：仅字面量/this/RegExp 读取安全。
|
||
/// 逻辑运算符快速路径的"无副作用"判定：左右两侧均安全时右值可急切发射
|
||
/// （三操作数 AND/OR/NULLISH 指令）。标识符读可能抛 ReferenceError（未声明名/
|
||
/// TDZ），不得判为无副作用，否则左值 falsy 时右值被求值破坏短路。
|
||
/// 算术表达式（`1 / a` 等）不得判为无副作用——对象操作数强转（ToNumber 触发
|
||
/// valueOf/toString/getter）可能在运行期抛错，急切求值会破坏 `||`/`&&` 短路。
|
||
pub fn is_side_effect_free(expr: &Expression) -> bool {
|
||
let mut stack = vec![expr];
|
||
while let Some(expr) = stack.pop() {
|
||
match expr {
|
||
Expression::NumericLiteral(_)
|
||
| Expression::StringLiteral(_)
|
||
| Expression::BooleanLiteral(_)
|
||
| Expression::NullLiteral(_)
|
||
| Expression::RegExpLiteral(_)
|
||
| Expression::ThisExpression(_) => {}
|
||
Expression::ParenthesizedExpression(p) => stack.push(&p.expression),
|
||
_ => return false,
|
||
}
|
||
}
|
||
true
|
||
}
|
||
|
||
impl Emitter {
|
||
/// 构造空 `Emitter`（静态编译口径：源文本为良形 UTF-8，无注入 marker）。
|
||
pub fn new() -> Self {
|
||
Self { source_encoded: false }
|
||
}
|
||
|
||
/// 置位编码源口径（见 [`Emitter::source_encoded`]）：仅动态编译入口
|
||
/// （eval / Function 构造器）经编译器设置。
|
||
pub fn with_source_encoded(mut self, enable: bool) -> Self {
|
||
self.source_encoded = enable;
|
||
self
|
||
}
|
||
}
|
||
|
||
impl Default for Emitter {
|
||
fn default() -> Self {
|
||
Self::new()
|
||
}
|
||
}
|