using WhiteMagic.Assembly;
namespace WhiteMagicTest;
///
/// Tests for emit primitives (,
/// , ) and
/// calling-convention stub encoding.
///
public class StubAssemblerTests
{
private static StubAssembler Create() => new();
// ── Emit primitives ────────────────────────────────────────────────────
[Fact]
public void EmitU8_appends_a_single_byte()
{
var sut = Create();
var buffer = new List();
sut.EmitU8(buffer, 0xAB);
Assert.Equal([0xAB], buffer);
}
[Fact]
public void EmitU32_appends_little_endian()
{
var sut = Create();
var buffer = new List();
sut.EmitU32(buffer, 0x11223344);
Assert.Equal([0x44, 0x33, 0x22, 0x11], buffer);
}
[Fact]
public void EmitU32_appends_zero()
{
var sut = Create();
var buffer = new List();
sut.EmitU32(buffer, 0);
Assert.Equal([0x00, 0x00, 0x00, 0x00], buffer);
}
[Fact]
public void EmitU64_appends_little_endian()
{
var sut = Create();
var buffer = new List();
sut.EmitU64(buffer, 0x1122334455667788);
byte[] expected = [0x88, 0x77, 0x66, 0x55, 0x44, 0x33, 0x22, 0x11];
Assert.Equal(expected, buffer);
}
[Fact]
public void EmitU64_appends_high_bits()
{
var sut = Create();
var buffer = new List();
sut.EmitU64(buffer, 0xDEADBEEF_CAFEBABE);
byte[] expected = [0xBE, 0xBA, 0xFE, 0xCA, 0xEF, 0xBE, 0xAD, 0xDE];
Assert.Equal(expected, buffer);
}
// ── IAssembler interface ───────────────────────────────────────────────
[Fact]
public void StubAssembler_is_an_IAssembler()
{
var sut = Create();
Assert.IsAssignableFrom(sut);
}
[Fact]
public void Assemble_from_StubAssembler_throws_NotSupported()
{
var sut = Create();
Assert.Throws(() => sut.Assemble("nop", 0));
}
// ── Calling convention: x86 cdecl ──────────────────────────────────────
[Fact]
public void Cdecl_stub_with_zero_args_is_call_then_ret()
{
var sut = Create();
IntPtr stubAddr = (IntPtr)0x10000000;
IntPtr target = (IntPtr)0x12345678;
uint[] args = [];
uint rel32 = (uint)target - ((uint)stubAddr + 5);
byte[] stub = sut.BuildCallStub(stubAddr, target, args, 4, CallingConvention.Cdecl);
Assert.Equal(6, stub.Length);
Assert.Equal(0xE8, stub[0]); // call
Assert.Equal(rel32, BitConverter.ToUInt32(stub, 1)); // rel32
Assert.Equal(0xC3, stub[5]); // ret
}
[Fact]
public void Cdecl_stub_one_arg_reverse_push_then_call_then_cleanup()
{
var sut = Create();
IntPtr stubAddr = (IntPtr)0x10000000;
IntPtr target = (IntPtr)0x12345678;
uint[] args = [0xAABBCCDD];
uint callAddr = (uint)stubAddr + 5;
uint rel32 = (uint)target - (callAddr + 5);
byte[] stub = sut.BuildCallStub(stubAddr, target, args, 4, CallingConvention.Cdecl);
byte[] expected = [
0x68, 0xDD, 0xCC, 0xBB, 0xAA, // push 0xAABBCCDD
0xE8,
(byte)rel32, (byte)(rel32 >> 8), (byte)(rel32 >> 16), (byte)(rel32 >> 24),
0x83, 0xC4, 0x04, // add esp, 4
0xC3 // ret
];
Assert.Equal(expected, stub);
}
[Fact]
public void Cdecl_stub_two_args_reverse_order()
{
var sut = Create();
IntPtr stubAddr = (IntPtr)0x10000000;
IntPtr target = (IntPtr)0x12345678;
uint[] args = [0x11111111, 0x22222222];
uint callAddr = (uint)stubAddr + 10;
uint rel32 = (uint)target - (callAddr + 5);
byte[] stub = sut.BuildCallStub(stubAddr, target, args, 4, CallingConvention.Cdecl);
byte[] expected = [
0x68, 0x22, 0x22, 0x22, 0x22, // push arg1 (reverse order)
0x68, 0x11, 0x11, 0x11, 0x11, // push arg0
0xE8,
(byte)rel32, (byte)(rel32 >> 8), (byte)(rel32 >> 16), (byte)(rel32 >> 24),
0x83, 0xC4, 0x08, // add esp, 8
0xC3
];
Assert.Equal(expected, stub);
}
}