unluac 1.2.3

Multi-dialect Lua decompiler written in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! 这个模块承载 raw -> low-IR 的 transformer 层。
//!
//! 它位于 parser 和 CFG 之间，职责是把各个 dialect 的原始指令模式一次性
//! lowering 成统一 low-IR，并顺手建立后续排错所需的 lowering 映射。

mod common;
mod debug;
mod dialect;
mod error;
mod operands;

pub use common::{
    AccessBase, AccessKey, BinaryOpInstr, BinaryOpKind, BranchCond, BranchInstr, BranchOperands,
    BranchPredicate, CallInstr, CallKind, Capture, CaptureSource, CloseInstr, ClosureInstr,
    ConcatInstr, CondOperand, ConstRef, DialectCaptureExtra, ErrNilInstr, GenericForCallInstr,
    GenericForLoopInstr, GetTableInstr, GetUpvalueInstr, InstrRef, JumpInstr, LoadBoolInstr,
    LoadConstInstr, LoadIntegerInstr, LoadNilInstr, LoadNumberInstr, LowInstr, LoweredChunk,
    LoweredProto, LoweringMap, MethodNameHint, MoveInstr, NewTableInstr, NumberLiteral,
    NumericForInitInstr, NumericForLoopInstr, ProtoRef, RawInstrRef, Reg, RegRange, ResultPack,
    ReturnInstr, SetListInstr, SetTableInstr, SetUpvalueInstr, TailCallInstr, TbcInstr,
    UnaryOpInstr, UnaryOpKind, UpvalueRef, ValueOperand, ValuePack, VarArgInstr,
};
pub use debug::{dump_lir, format_low_instr};
pub use error::TransformError;

use crate::decompile::{DecompileContext, DecompileDialect, DecompileError, DecompileState};
use crate::parser::RawChunk;

/// Transform 阶段入口：从 Parse 槽位读取 raw chunk，写回统一 low-IR。
pub(crate) fn lower_chunk(
    state: &mut DecompileState,
    _context: &DecompileContext<'_>,
) -> Result<(), DecompileError> {
    let raw_chunk = state.raw_chunk.as_ref().unwrap();
    state.lowered = Some(match raw_chunk.header.version {
        DecompileDialect::Lua51 => dialect::lua51::lower_chunk(raw_chunk),
        DecompileDialect::Lua52 => dialect::lua52::lower_chunk(raw_chunk),
        DecompileDialect::Lua53 => dialect::lua53::lower_chunk(raw_chunk),
        DecompileDialect::Lua54 => dialect::lua54::lower_chunk(raw_chunk),
        DecompileDialect::Lua55 => dialect::lua55::lower_chunk(raw_chunk),
        DecompileDialect::Luajit => dialect::luajit::lower_chunk(raw_chunk),
        DecompileDialect::Luau => dialect::luau::lower_chunk(raw_chunk),
    }?);
    Ok(())
}

/// 根据 chunk 的实际 dialect 自动选择 lowering 实现。
pub fn lower_raw_chunk(chunk: &RawChunk) -> Result<LoweredChunk, TransformError> {
    match chunk.header.version {
        DecompileDialect::Lua51 => dialect::lua51::lower_chunk(chunk),
        DecompileDialect::Lua52 => dialect::lua52::lower_chunk(chunk),
        DecompileDialect::Lua53 => dialect::lua53::lower_chunk(chunk),
        DecompileDialect::Lua54 => dialect::lua54::lower_chunk(chunk),
        DecompileDialect::Lua55 => dialect::lua55::lower_chunk(chunk),
        DecompileDialect::Luajit => dialect::luajit::lower_chunk(chunk),
        DecompileDialect::Luau => dialect::luau::lower_chunk(chunk),
    }
}