// Регистр-регистр
add(rax, rbx);           // 48 01 D8
sub(ecx, edx);           // 29 D1
and_(r8, r9);            // 4D 21 C8
or_(rsi, rdi);           // 48 09 FE
xor_(eax, eax);          // 31 C0 (распространённый способ обнуления регистра)
cmp(rax, rcx);           // 48 39 C8

// Регистр с непосредственным значением
add(rax, 0x10);          // 48 83 C0 10 (знаковое расширение imm8)
add(rax, 0x10000);       // 48 05 00 00 01 00 (imm32)
sub(ecx, 100);           // 83 E9 64
and_(rdx, 0xFF);         // 48 83 E2 FF

// С операндами в памяти
add(eax, dword_ptr(rbx));              // 03 03
add(rax, qword_ptr(rcx + 0x10));       // 48 03 41 10
sub(dword_ptr(rsp + 0x20), eax);       // 29 44 24 20

// Регистр-регистр
mov(rax, rbx);           // 48 89 D8
mov(eax, ecx);           // 89 C8
mov(r8, r9);             // 4D 89 C8

// Непосредственное значение в регистр
mov(rax, 0x12345678);    // 48 C7 C0 78 56 34 12
mov(eax, 0xDEADBEEF);    // B8 EF BE AD DE

// Операции с памятью
mov(rax, qword_ptr(rbx));              // 48 8B 03
mov(eax, dword_ptr(rcx + 0x10));       // 8B 41 10
mov(qword_ptr(rsp + 0x8), rax);        // 48 89 44 24 08
mov(dword_ptr(rbp - 0x20), 0x100);     // C7 45 E0 00 01 00 00

// Расширение нулём / знаком
movzx(eax, bl);          // 0F B6 C3 (расширение байта нулём до двойного слова)
movzx(rax, bx);          // 48 0F B7 C3 (расширение слова нулём до учётверённого слова)
movsx(eax, cl);          // 0F BE C1 (расширение байта знаком до двойного слова)
movsx(rax, dx);          // 48 0F BF C2 (расширение слова знаком до учётверённого слова)
movsxd(rax, ecx);        // 48 63 C1 (расширение двойного слова знаком до учётверённого слова)

// Загрузка эффективного адреса
lea(rax, qword_ptr(rbx + rcx * s4));           // 48 8D 04 8B
lea(rax, qword_ptr(rbx + rcx * s8 + 0x10));    // 48 8D 44 CB 10

// Обмен
xchg(rax, rbx);          // 48 87 D8

// [база + индекс*масштаб]
mov(eax, dword_ptr(rbx + rcx * s1));   // 8B 04 0B
mov(eax, dword_ptr(rbx + rcx * s2));   // 8B 04 4B
mov(eax, dword_ptr(rbx + rcx * s4));   // 8B 04 8B
mov(eax, dword_ptr(rbx + rcx * s8));   // 8B 04 CB

// [база + индекс*масштаб + смещение]
mov(rax, qword_ptr(rbx + rcx * s4 + 0x10));     // 48 8B 44 8B 10
mov(rax, qword_ptr(r12 + r13 * s8 + 0x1000));   // 4B 8B 84 EC 00 10 00 00

// Запись по SIB-адресу
mov(dword_ptr(rax + rdx * s4), ecx);            // 89 0C 90
mov(qword_ptr(rbx + rsi * s8 + 0x20), rax);     // 48 89 44 F3 20

// LEA с SIB (полезно для вычисления адресов)
lea(rax, qword_ptr(rbx + rcx * s4));            // 48 8D 04 8B
lea(rax, qword_ptr(rdi + rsi * s8 + 0x100));    // 48 8D 84 F7 00 01 00 00

// Сдвиг на 1
shl(eax, 1);             // D1 E0
shr(rax, 1);             // 48 D1 E8
sar(ecx, 1);             // D1 F9

// Сдвиг на непосредственное значение
shl(eax, 4);             // C1 E0 04
shr(rax, 8);             // 48 C1 E8 08
sar(rdx, 16);            // 48 C1 FA 10

// Сдвиг на регистр CL
shl(eax, cl);            // D3 E0
shr(rax, cl);            // 48 D3 E8

// Вращение
rol(eax, 1);             // D1 C0
ror(rax, 8);             // 48 C1 C8 08
rcl(ecx, cl);            // D3 D1
rcr(rdx, 1);             // 48 D1 DA

// Однооперандные (результат в rdx:rax)
mul(rbx);                // 48 F7 E3 (беззнаковое: rdx:rax = rax * rbx)
imul(rcx);               // 48 F7 E9 (знаковое: rdx:rax = rax * rcx)
div(rbx);                // 48 F7 F3 (беззнаковое: rax = rdx:rax / rbx, rdx = остаток)
idiv(rcx);               // 48 F7 F9 (знаковое деление)

// Двухоперандный IMUL (результат = результат * источник)
imul(rax, rbx);          // 48 0F AF C3
imul(ecx, edx);          // 0F AF CA

// Трёхоперандный IMUL (результат = источник * непосредственное)
imul(rax, rbx, 10);      // 48 6B C3 0A
imul(ecx, edx, 1000);    // 69 CA E8 03 00 00

// Безусловные переходы
jmp(0x10);               // EB 10 (короткий, 8-битное смещение)
jmp(0x1000);             // E9 00 10 00 00 (близкий, 32-битное смещение)
jmp(rax);                // FF E0 (косвенный)
jmp(here);               // EB FE (jmp $, бесконечный цикл)

// Условные переходы (8-битное смещение)
jz(0x10);                // 74 10
jnz(0x20);               // 75 20
jb(0x08);                // 72 08 (ниже/перенос)
jae(0x08);               // 73 08 (выше или равно/нет переноса)
jl(0x10);                // 7C 10 (меньше, знаковое)
jge(0x10);               // 7D 10 (больше или равно, знаковое)

// Условные переходы (32-битное смещение для длинных ветвей)
jz_near(0x10000);        // 0F 84 00 00 01 00
jnz_near(0x20000);       // 0F 85 00 00 02 00

// Вызов и возврат
call(rax);               // FF D0 (косвенный вызов)
call(0x100);             // E8 00 01 00 00 (относительный вызов)
ret();                   // C3
ret(0x10);               // C2 10 00 (возврат и извлечение 16 байт)

// Пересылка, если условие истинно (без штрафа за ветвление!)
cmovz(rax, rbx);         // 48 0F 44 C3 (переслать, если ноль)
cmovnz(eax, ecx);        // 0F 45 C1 (переслать, если не ноль)
cmovl(rax, rdx);         // 48 0F 4C C2 (переслать, если меньше, знаковое)
cmovge(ecx, esi);        // 0F 4D CE (переслать, если больше или равно, знаковое)
cmovb(rax, rbx);         // 48 0F 42 C3 (переслать, если ниже, беззнаковое)
cmovae(edx, edi);        // 0F 43 D7 (переслать, если выше или равно, беззнаковое)

// С источником в памяти
cmovz(rax, qword_ptr(rbx));           // 48 0F 44 03
cmovnz(eax, dword_ptr(rcx + 0x10));   // 0F 45 41 10

// Тест бита
bt(eax, 5);              // 0F BA E0 05
bt(rax, rbx);            // 48 0F A3 D8

// Тест бита и установка/сброс/дополнение
bts(eax, 10);            // 0F BA E8 0A (тест и установка)
btr(rax, rcx);           // 48 0F B3 C8 (тест и сброс)
btc(edx, 3);             // 0F BA FA 03 (тест и дополнение)

// Сканирование бита
bsf(eax, ecx);           // 0F BC C1 (сканирование вперёд для первого 1)
bsr(rax, rbx);           // 48 0F BD C3 (сканирование назад для первого 1)

// Подсчёт единиц и ведущие/конечные нули
popcnt(eax, ecx);        // F3 0F B8 C1
lzcnt(rax, rbx);         // F3 48 0F BD C3
tzcnt(eax, edx);         // F3 0F BC C2

// Перестановка байт
bswap(eax);              // 0F C8 (обратный порядок байт)
bswap(rax);              // 48 0F C8

// Базовые строковые операции (работают с [rsi] и/или [rdi])
movsb();                 // A4 (переместить байт [rsi] -> [rdi])
movsw();                 // 66 A5
movsd();                 // A5
movsq();                 // 48 A5

cmpsb();                 // A6 (сравнить [rsi] с [rdi])
stosb();                 // AA (записать al -> [rdi])
lodsb();                 // AC (загрузить [rsi] -> al)
scasb();                 // AE (сравнить al с [rdi])

// С префиксом REP (повторить rcx раз)
rep_movsb();             // F3 A4 (memcpy)
rep_movsq();             // F3 48 A5 (быстрый memcpy, по 8 байт за раз)
rep_stosb();             // F3 AA (memset)
rep_stosq();             // F3 48 AB

// С префиксами REPE/REPNE (повторять, пока равно/не равно)
repe_cmpsb();            // F3 A6 (сравнение строк до несовпадения)
repne_scasb();           // F2 AE (поиск байта в строке)

push(rax);               // 50
push(rbx);               // 53
push(r8);                // 41 50
push(0x10);              // 6A 10 (поместить imm8)
push(0x1000);            // 68 00 10 00 00 (поместить imm32)

pop(rax);                // 58
pop(rbx);                // 5B
pop(r15);                // 41 5F

// Системные вызовы
syscall_();              // 0F 05 (64-битный syscall)
sysenter();              // 0F 34
sysexit();               // 0F 35

// Прерывания
int3();                  // CC (точка останова)
int_(0x80);              // CD 80 (Linux 32-битный syscall)
int_(0x21);              // CD 21 (прерывание DOS)

// Информация о CPU
cpuid();                 // 0F A2
rdtsc();                 // 0F 31
rdtscp();                // 0F 01 F9

// Привилегированные
cli();                   // FA (запрет прерываний)
sti();                   // FB (разрешение прерываний)
hlt();                   // F4 (останов)

// Возврат из прерывания
iret();                  // CF (16-битный)
iretd();                 // CF (32-битный)
iretq();                 // 48 CF (64-битный)

constexpr auto prologue = core::assemble(
    push(rbp),
    mov(rbp, rsp),
    sub(rsp, 0x20)
);

constexpr auto epilogue = core::assemble(
    add(rsp, 0x20),
    pop(rbp),
    ret()
);

// Объединение
constexpr auto full_function = core::assemble(prologue, epilogue);

include(FetchContent)
FetchContent_Declare(
    static_asm
    GIT_REPOSITORY https://github.com/mahmoudimus/static_asm.git
    GIT_TAG v1.0.0  # или конкретный коммит
)
FetchContent_MakeAvailable(static_asm)

target_link_libraries(your_target PRIVATE static_asm::static_asm)

git submodule add https://github.com/mahmoudimus/static_asm.git external/static_asm

add_subdirectory(external/static_asm)
target_link_libraries(your_target PRIVATE static_asm::static_asm)

#include "static_asm.hpp"

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --install build --prefix /usr/local

find_package(static_asm REQUIRED)
target_link_libraries(your_target PRIVATE static_asm::static_asm)

# Конфигурация
cmake -B build -DCMAKE_BUILD_TYPE=Release

# Сборка
cmake --build build

# Запуск тестов
ctest --test-dir build --output-on-failure

# Сборка с примерами (только Clang, использует встроенный ассемблер)
cmake -B build -DCMAKE_BUILD_TYPE=Release -DSTATIC_ASM_BUILD_EXAMPLES=ON

# Установка uv (если ещё не установлен)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Проверка установки
uv --version

# Все Python-скрипты можно запускать напрямую через uv (зависимости управляются автоматически)
uv run scripts/gen_from_x86ref.py --help
uv run scripts/amalgamate.sh

# Показать сводку базы инструкций
uv run scripts/gen_from_x86ref.py

# Показать подробности для конкретной инструкции
uv run scripts/gen_from_x86ref.py -i lea
uv run scripts/gen_from_x86ref.py -i imul

# Сгенерировать файлы базы инструкций
uv run scripts/gen_from_x86ref.py --generate-db

# Сгенерировать исчерпывающий тестовый файл
uv run scripts/gen_from_x86ref.py --generate-tests

// Предпочтительно: обернуть реализацию в пространство имён
namespace MyLib {
    Foo::Foo() {
        // ...
    }
}

// Явная квалификация (более многословно, но очень понятно)
MyLib::Foo::Foo() {
    // ...
}

namespace MyLib {
    namespace detail {           // очень широко используется
        // внутренние классы, функции и т.д.
    }
}

namespace MyLib::impl {          // короче, также распространено
    // детали внутренней реализации
}

namespace MyLib::detail {
    class InternalHelper { /* ... */ };
}

// До (в .cpp)
namespace MyLib {
    static int s_counter = 0;

    int next_id() {
        return ++s_counter;
    }
}

// После (безопасно для заголовка)
namespace MyLib::detail {
    struct Globals {
        static inline int counter = 0;
    };
}

inline int MyLib::next_id() {
    return ++detail::Globals::counter;
}

// MyLib.h (или общий заголовок)
#define inline_t   /* пусто при обычной сборке */

// MyLib.cpp (во время разработки)
namespace MyLib::detail {
    inline_t void Helper::do_work() {
        // реализация
    }
}

// После объединения / преобразования
inline void MyLib::detail::Helper::do_work() {
    // ...
}