GrassGreen G&G v4.0
Спонсор Sponsor GitHub 5
Ядро версии 4.0: The Evolution Core v4.0 Release: The Evolution

Высокопроизводительный байткод-язык системного уровня

High-Performance System-Level Bytecode Language

C++ синтаксис · Собственная Stack VM Proprietary Stack VM · Нативная сборка в Win32 PE .exe Native Win32 PE .exe Packing

Скачать компилятор grg (v4.0) Download grg Compiler (v4.0) Читать документацию Read Documentation
$ grg main.grass
Interactive Code Showcase

Синтаксис нового поколения G&G

Next-Generation G&G Syntax

Простота C++, прямой потоковый вывод `gout`, встроенная математика и нативные Win32 GUI компоненты без громоздких фреймворков.

C++ elegance, direct `gout` stream I/O, built-in vector math, and native Win32 GUI engine without heavy external frameworks.

!GrassGreen!

// Быстрый старт: точка входа main() и потоковый вывод gout
int main() {
    take project = "GrassGreen";
    take version = 4.0;

    gout << "Добро пожаловать в " << project << " v" << version << endl;
    gout << "Stack VM Direct-Threaded Dispatcher активен." << endl;

    return 0;
}
!GrassGreen!

// Quick start: main() entry point and gout stream I/O
int main() {
    take project = "GrassGreen";
    take version = 4.0;

    gout << "Welcome to " << project << " v" << version << endl;
    gout << "Stack VM Direct-Threaded Dispatcher is active." << endl;

    return 0;
}
!GrassGreen!
!FastMath!
!time!

// Демонстрация скорости: вычисления с таймером и интерполяцией lerp
int main() {
    start_time();

    take total = 0.0;
    for (take i = 1; i <= 50000; i++) {
        take t = i / 50000.0;
        take factor = lerp(1.0, 2.5, t);
        total = total + sin(t) * discor(i) * factor;
    }

    stop_time();

    gout << "Итоговый результат: " << total << endl;
    gout << "Время расчёта 50к итераций: " << conclus_time() << endl;

    return 0;
}
!GrassGreen!
!FastMath!
!time!

// Performance demo: fast math with execution timer and lerp interpolation
int main() {
    start_time();

    take total = 0.0;
    for (take i = 1; i <= 50000; i++) {
        take t = i / 50000.0;
        take factor = lerp(1.0, 2.5, t);
        total = total + sin(t) * discor(i) * factor;
    }

    stop_time();

    gout << "Computation result: " << total << endl;
    gout << "Time for 50k iterations: " << conclus_time() << endl;

    return 0;
}
!GrassGreen!
!interface!

// Нативный оконный интерфейс Win32 / GDI+ без сторонних рантаймов
int main() {
    window();
    title("GrassGreen 4.0 Native GUI");
    size(480, 320);
    theme("dark");
    color("#09090b");

    label("Автономный Win32 GUI движок");
    font-size(16);
    middle();

    button("Собрать в .exe");
    button-color("#15803d");
    radius(8);

    show;
    return 0;
}
!GrassGreen!
!interface!

// Native Win32 / GDI+ window UI without external runtimes
int main() {
    window();
    title("GrassGreen 4.0 Native GUI");
    size(480, 320);
    theme("dark");
    color("#09090b");

    label("Standalone Win32 GUI Engine");
    font-size(16);
    middle();

    button("Build to .exe");
    button-color("#15803d");
    radius(8);

    show;
    return 0;
}
Architecture & Core

Ключевые преимущества ядра

Key Architecture Advantages

Спроектирован с нуля для максимальной энергоэффективности, предсказуемого выполнения без пауз GC и глубокого аппаратного доступа.

Designed from scratch for peak throughput, zero-GC pause predictability, and direct bare-metal hardware access.

Автономный PE .exe упаковщик

Standalone PE .exe Packer

Сборка программ в самостоятельные бинарные исполняемые файлы Win32 PE. Байт-код компонуется в тело загрузчика (`-emit-exe`), позволяя запускать приложение на любом компьютере без установки сторонних сред, Node.js или Python.

Compiles programs into standalone Win32 PE binary executable files. Bytecode is packed directly with the native runner (`-emit-exe`), running instantly on any machine without runtime dependencies.

Win32 PE Loader -emit-exe Zero Runtime Dependency

Direct-Threaded VM (v4.0)

Direct-Threaded VM (v4.0)

Прямая диспетчеризация инструкций через Labels-as-Values (`computed goto` / `goto *dispatch_table[op]`). Полное устранение циклов `while(switch)` и накладных расходов ветвления с аппаратным JIT-ускорением горячих циклов x86_64.

Instruction dispatch via Labels-as-Values (`computed goto` table pointers). Completely eliminates `switch` loops and branch overhead, paired with a native x86_64 JIT compiler for critical hot loops.

Computed Goto x86_64 SSE2 JIT Opcode Fusion

Arena Allocator & NaN-Boxing

Arena Allocator & NaN-Boxing

Выделение памяти со сдвигом указателя (bump-pointer) без фрагментации ОЗУ и освобождением целых пулов в O(1). Все базовые значения упакованы в 64-битный формат IEEE 754 (ровно 8 байт), снижая нагрузку на L1-кэш процессора в 2 раза.

Bump-pointer linear memory allocation with zero fragmentation and instant O(1) pool release. All primitives fit into a flat 64-bit IEEE 754 NaN-box (strictly 8 bytes), halving CPU L1 cache bandwidth pressure.

Bump Pointer 8-Byte Values C-ABI Alignment

Аппаратный доступ и Freestanding

Hardware Access & Freestanding

Режим сборки без libc (`--freestanding`) через GrassHAL для микроконтроллеров и загрузчиков ОС. Прямое чтение/запись физических адресов (MMIO, VGA 0xB8000), аппаратные порты ввода-вывода x86 (`inb`/`outb`), квалификатор `volatile` и барьеры памяти.

Independent freestanding build mode without libc (`--freestanding`) for microcontrollers and OS bootloaders. Direct memory-mapped I/O (MMIO), x86 Port I/O (`inb`/`outb`), `volatile` memory qualifiers, and hardware barriers.

GrassHAL MMIO & Port I/O Memory Barriers
Standard Library

Каталог встроенных библиотек

Standard Library Catalog

18 системных библиотек из официальной директории docs/. Нажмите на модуль для просмотра функций и вызовов.

18 core modules straight from the official docs/ directory. Click any module to inspect functions and signatures.

Модулей: 18 / 18 Modules: 18 / 18

!FastMath!

docs/fastmath.md

Быстрая вычислительная математика для игр и физики: тригонометрия, интерполяция lerp, модуль, квадратный корень.

High-speed computational math: trigonometry, linear interpolation (lerp), absolute value, square root discor(x).

discor(x) Квадратный корень из числа для точного расчета дистанций.
sin(x) / cos(x) Тригонометрические функции угла.
lerp(start, end, t) Линейная интерполяция между точками по коэффициенту времени t.
abs(x), round(x), min(a,b), max(a,b) Модуль, округление до целого, экстремумы величин.
rand(min, max) Генератор псевдослучайных чисел в заданном диапазоне.

!CoreMath!

docs/coremath.md

Высокоточная математика, криптографические алгоритмы и базовая квантовая симуляция кубитов.

High-precision arithmetic, cryptographic primitives, and quantum qubit simulation.

qb_init() Инициализация квантового бита в базовое состояние.
h(q) Вентиль Адамара: перевод кубита в 50/50 суперпозицию.
q_rand(q) Измерение кубита с коллапсом суперпозиции в непредсказуемый 0 или 1.
gcd(a, b) Наибольший общий делитель для криптографических алгоритмов.
pi(), pow_e(b, e) Число Пи сверхвысокой точности и возведение больших чисел в степень.

!2DGraphics!

docs/2DGraphics.md

Графический 2D-движок: холст, двойная буферизация, примитивы, опрос клавиатуры и AABB-коллизии.

2D graphics engine: double buffering, geometric primitives, real-time keyboard polling, and AABB collisions.

create_canvas(w, h), save_image(path) Создание холста и сохранение в файл.
gfx_init(title, w, h), gfx_running() Инициализация аппаратного окна и опрос цикла событий.
gfx_rect, gfx_circle, gfx_line, gfx_text Отрисовка примитивов и текста с заданной толщиной и палитрой.
gfx_key(key_name) Проверка нажатия клавиш клавиатуры (WASD, стрелки, ESC).
gfx_collide(x1, y1, w1, h1, x2, y2, w2, h2) Аппаратная проверка пересечения двух прямоугольных объектов.

!interface!

docs/interface.md

Оконный GUI Windows (Win32/GDI+): формы, темные темы, кнопки, поля ввода, выравнивание и закругления.

Native Windows GUI stack: forms, dark/light themes, buttons, text fields, layouts, and click triggers.

window(), title(str), size(w, h), show Конфигурация параметров главного окна и вывод на экран.
theme("dark"), color("#hex"), glass Стилизация формы, подложки и эффекты прозрачности Mica/Aero.
button(txt), button-color(c), radius(r) Интерактивные кнопки с кастомным закруглением и обработчиком click-ob.
label(txt), enter(), font-size(n) Текстовые блоки и поля ввода информации.

!GrassNet!

docs/GrassNet.md

Сетевой стек: TCP/IP сокет-серверы, HTTP/HTTPS запросы, ping, DNS резолвер и загрузка файлов.

Network engine: TCP/IP socket servers, HTTP/HTTPS client, ICMP ping, DNS resolver, and file download.

create_serv() { port, IP, password } Конфигурация и запуск выделенного сетевого TCP-сервера.
connect(ip, port), accept(), net_close() Установка клиентского соединения и управление сокетами.
send(url, method, body), net_status() Отправка HTTP-запросов и получение статус-кодов.
ping(host), resolve_ip(domain), download(url, path) Диагностика задержки, DNS резолв и прямое скачивание на диск.

!fsys!

docs/fsys.md

Файловая система: чтение и запись файлов, создание каталогов, копирование, замер размеров и обход папок.

Filesystem API: reading and writing files, directory traversal, file size queries, and stream operations.

fs_read(path), fs_write(path, text) Текстовое чтение и перезапись содержимого файла.
fs_append(path, text), fs_delete(path) Дописывание в конец файла и удаление с диска.
fs_mkdir(path), fs_list(path), fs_is_dir(path) Создание папок и получение списков вложенных файлов.
fs_size(path), fs_exists(path) Проверка наличия файла и определение размера в байтах.

!memory!

docs/memory.md

Управление памятью: Arena Allocator, замер объема ОЗУ процесса, непрерывные бинарные буферы и отладочный дамп.

Memory management: Arena Allocator control, process RAM monitoring, raw binary buffers, and memory dump.

memory_clean(), memory_auto() Мгновенный сброс арены памяти и автоподбор размера пулов.
memory_alloc(bytes), memory_free_block(id) Выделение непрерывного буфера памяти под бинарные структуры.
memory_usit(), memory_free() Объем памяти процесса (в МБ) и доступная свободная память ПК.
memory_dump(), memory_limit(mb) Слепок стека виртуальной машины и аппаратный лимит потребления.

!json!

docs/json.md

Парсер, сериализатор и построитель JSON-структур, проверка валидности синтаксиса и сжатие строк.

JSON parser, serializer, and dynamic builder with syntax validation and payload minification.

json_get(str, path), json_set(str, key, val) Чтение по точечному пути и запись полей в JSON-строке.
json_valid(str), json_minify(str) Проверка валидности синтаксиса и удаление лишних пробелов.
json_add(k, v), json_build(), json_clear() Пошаговое построение JSON-объекта в буфере.

!proc!

docs/proc.md

Управление процессами Windows: поиск процессов по имени, PID, мониторинг памяти и принудительное завершение.

Windows process management: lookup by executable name, PID inspection, memory usage, and termination.

proc_find(name) Поиск процесса по имени .exe, возвращает числовой PID.
proc_kill(pid), proc_exists(pid) Принудительное завершение и проверка активности процесса.
proc_mem(pid), proc_list() Замер ОЗУ процесса в МБ и получение списка всех задач в ОС.

!time!

docs/time.md

Высокоточные системные часы, миллисекундный бенчмаркинг блоков инструкций, метки даты и времени.

High-precision monotonic hardware clocks, block execution timers, and formatted timestamps.

start_time(), stop_time(), conclus_time() Запуск таймера, остановка и получение отформатированной строки.
clock_ms() / now_ms() Монотонное аппаратное время системы в миллисекундах.
time(), get_date(), get_time_str() UNIX-таймстемп и строковые представления календарной даты.

!random!

docs/random.md

Генератор псевдослучайных величин: целые и дробные числа в диапазоне, случайные строки букв и управление зерном.

Pseudorandom generator: ranged integers and floats, random strings, and deterministic seed locking.

rand_int(min, max), rand_float(min, max) Случайное целое или число с плавающей точкой в заданных границах.
random_txt("rus" | "en") Генерация последовательности случайных буквенных символов.
stop_random(), play_random() Фиксация текущего значения генератора и возобновление работы.

!mmio!

docs/mmio.md

Аппаратный доступ к физической памяти: чтение/запись 8-64 бит, порты x86 inb/outb, барьеры памяти mfence/lfence.

Direct hardware MMIO: 8-64 bit physical memory access, x86 Port I/O, mfence/lfence barriers, and volatile qualifiers.

mmio_read8/16/32/64(addr) Прямое чтение байта, слова или двойного слова по физическому адресу.
mmio_write8/16/32/64(addr, val) Прямая запись в физический адрес памяти (видеобуфер VGA 0xB8000, APIC).
inb(p), outb(p, v), io_in32, io_out32 Низкоуровневые инструкции аппаратных портов ввода-вывода x86.
memory_barrier(), read_barrier(), write_barrier() Аппаратные барьеры сериализации инструкций процессора.

!thread!

docs/thread.md

Многопоточность ядра: параллельные потоки ОС, фоновые асинхронные задачи, системные мьютексы и синхронизация.

Core concurrency: OS threads, async tasks, system mutexes, thread join/detach, and shared environment.

thread(fn, ...args), thread_join(t) Запуск функции в системном потоке и ожидание возвращаемого значения.
async fn(...args); Запуск фоновой асинхронной задачи без блокировки основного кода.
mutex_create(), mutex_lock(m), mutex_unlock(m) Создание мьютекса и защита критической секции от гонок данных.
thread_id(), thread_sleep(ms) Получение TID потока и задержка выполнения в миллисекундах.

!database!

docs/gdb.md

Встроенный Key-Value движок базы данных GSE (файлы `.gdb`): таблицы, автосохранение, XOR-HEX шифрование и экспорт в JSON.

Embedded Key-Value GSE database engine (.gdb): tables, auto-save, XOR-HEX key encryption, and JSON export.

db_open(path), db_save(path), db_autosave(1) Загрузка и сохранение базы данных на диск с автоматическим сбросом.
db_set(k, v), db_get(k), db_has(k), db_del(k) Основные операции Key-Value хранилища в оперативной памяти.
db_encrypt(k), db_decrypt(k), db_hash(s) Криптографическая защита значений и вычисление хеша сессии.
table(name) ... end-table Секционирование данных по именованным таблицам.

!sys!

docs/sys.md

Диагностика Windows: системный буфер обмена (Ctrl+C/V), разрешение монитора, количество ядер CPU, аптайм.

Windows environment diagnostics: system clipboard integration, monitor resolution, CPU topology, and uptime.

clip_set(txt), clip_get() Копирование и считывание текста из системного буфера обмена.
screen_w(), screen_h() Ширина и высота экрана основного монитора в пикселях.
cpu_cores(), ram_total_mb(), uptime_sec() Число логических ядер, физическое ОЗУ и время работы ПК.

!tg!

docs/tg.md

Разработка Telegram-ботов: инициализация сессии по Bot API токену, отправка сообщений, фото и документов.

Telegram Bot API: session initialization, incoming updates poll, message, photo, and document transmission.

telegram_init(token) Авторизация сессии бота в Telegram Bot API.
send_message(chat_id, text) Отправка форматированного текстового сообщения в чат.
get_updates(), send_photo, send_document Прием входящих событий и отправка медиафайлов.

!GrassWeb!

docs/WEB.md

Декларативный фронтенд-DSL для создания интерактивных веб-страниц, обработки кликов, ввода и таймеров.

Declarative web-scripting DSL: reactive events, DOM manipulations, intervals, and localStorage persistence.

script-start ... script-end Блок реактивной логики веб-интерфейса.
on-click(id), on-input(id), every(ms) Обработчики пользовательских действий и таймеров.
set-text(id, t), val(id), save(k, v), load(k) Манипуляции DOM-элементами и постоянное хранилище браузера.

!GrassGreen!

docs/main.md

Базовое ядро языка: `gout`, `gin`, типы данных, структуры `struct`, массивы `array`, строки `len`/`substr`, вызов `msgbox` и `system`.

Core language runtime: `gout`/`gin` I/O streams, `struct` types, dynamic arrays, string utilities, and Win32 system bridges.

gout << val << endl; / gin >> var; Потоковый вывод и ввод через системные вызовы Win32 WriteFile.
struct Name { f1: u32, f2: u64 } Пользовательские структуры со строгим C-ABI выравниванием полей.
import "file.grass"; Импорт модулей с защитой от циклов (#pragma once).
len(s), upper(s), lower(s), substr(s, p, l), trim(s) Строковый API высокой производительности.
msgbox(title, text), beep(f, d), clear() Системные вызовы Windows и управление консолью.
The Evolution

Дорожная карта ядра v4.0

Core Roadmap v4.0 (The Evolution)

20 пунктов архитектурной эволюции ядра GrassGreen: от Stack VM к автономному системному языку с нативным JIT и Freestanding режимом.

All 20 architectural evolution milestones from plans/ROADMAP.md: transitioning into an autonomous freestanding system language.

п. 1

Минимальный JIT-компилятор

Minimal x86_64 JIT Compiler

Complete

Генерация нативных машинных инструкций x86_64 для критических горячих участков байт-кода. Выделение страниц PAGE_EXECUTE_READWRITE, работа с SSE2 регистрами (xmm0, xmm1), соответствие Microsoft x64 ABI и флаг компилятора `--jit` (авто-включение при `-O3`).

Generates native x86_64 machine code for hot execution loops using SSE2 registers and Microsoft x64 ABI calling conventions with `--jit` CLI switch.

п. 2

Динамические массивы: `array`

Dynamic Arrays: `array`

Complete

Векторные структуры динамического и фиксированного размера с быстрой индексацией `arr[i]`, методами `items.push(val)`, `items.pop()` и встроенной функцией длины `len(items)`.

Vector structures with rapid `arr[i]` indexing, push/pop operations, and O(1) length inspection via `len()`.

п. 3

Автодополнение (IntelliSense) по всем библиотекам

IntelliSense Snippets Across All Libraries

Complete

Подсказка встроенных функций, методов и констант библиотек в реальном времени через богатый набор сниппетов: `main`, `gout`, `gin`, `fn`, `struct`, `thread`, `async`, `mutex`, `mmio_read`, `mmio_write`, `inb`, `outb`, `barrier`, `gfx_app`.

Real-time completions across all 18 standard libraries in VS Code via comprehensive snippets schema.

п. 4

Подсветка синтаксиса по всем библиотекам

TextMate Syntax Highlighting

Complete

Разработка TextMate грамматики (`syntaxes/grassgreen.tmLanguage.json`) для всех ключевых слов, директив `!module!`, структур, типов, потоков `gout`/`gin` и операторов сдвига `<<`/`>>`.

TextMate grammar covering all tokens, directives, types, stream operators, and library calls.

п. 5

Интеграция в системный PATH и графический установщик

System PATH Integration & Win32 Installer

Complete

Полноценный автономный GUI инсталлятор `setup.exe` в темной теме GrassGreen. Упаковка `grg.exe`, ассоциации расширений `.grass` и `.gdb`, тихий режим (`setup.exe /silent`), авто-запись в реестр HKCU/HKLM PATH с широковещательным WM_SETTINGCHANGE.

Standalone dark-themed setup.exe with silent mode (`setup.exe /silent`), file associations, and instant PATH broadcast.

п. 6

Перевод языка в режим Freestanding

Freestanding Bare-Metal Mode

Complete

Полная независимость от стандартных библиотек C++ (работа без libc / libc++ / iostream через модуль аппаратной абстракции GrassHAL). Ядро готово к выполнению в bare-metal окружении, микроконтроллерах и загрузчиках ОС.

Zero dependency on libc or iostream via GrassHAL abstraction layer, ready for OS loaders and embedded targets.

п. 7

Табличная диспетчеризация (Dispatch Table)

Table-Based Dispatch (Dispatch Table)

Complete

Уход от медленного цикла `while(switch)`. Массив прямых указателей на обработчики опкодов для мгновенного перехода между инструкциями виртуальной машины.

Replaces branch-heavy switch constructs with a direct array of opcode function pointers.

п. 8

Склейка AST и разрешение зависимостей (Import Pass)

AST Merging & Dependency Resolution (Import Pass)

Complete

Разрешение зависимостей на этапе построения дерева с рекурсивным обходом, канонической нормализацией путей, семантикой `#pragma once` (защита от циклов и ромбовидных импортов) и поддержкой RamFS.

Recursive dependency resolution, path canonicalization, `#pragma once` diamond protection, and RamFS support.

п. 9

Bytecode Layout & Fusion Optimizer

Bytecode Layout & Fusion Optimizer

Complete

Многопроходный оптимизатор: Opcode Fusion (слияние цепочек констант и арифметики в `OP_ADD_CONST`, инкрементов в `OP_INC_VAR`), Constant Folding, Dead Code Elimination и Jump Relocation. Ускорение циклов в 2.6 раза при `-O3`.

Multi-pass optimizer: opcode fusion, constant folding, dead-code elimination, and jump relocation delivering 2.6x loop speedup.

п. 10

Пользовательские структуры: `struct`

User Structures: `struct`

Complete

Синтаксис объявления составных типов данных (`struct Player { hp: u32, x: u64 }`) с расчетом смещения полей в байтах на этапе компиляции и прямым доступом через точку.

Custom compound types with compile-time byte offset calculations and dot-notation access.

п. 11

Настоящий импорт файлов: `import` / `include`

Modular File Imports: `import` / `include`

Complete

Поддержка полноценных модулей на самом языке `.grass`: синтаксисы `import "module.grass";`, `include "module";`, `#include <module.grass>` со сквозным вызовом структур и функций из `main()`.

Write re-usable modules directly in `.grass` files with seamless cross-module function and struct calls.

п. 12

Многопоточность: `thread` / `async`

Concurrency: `thread` / `async`

Complete

Асинхронные задачи и системные потоки операционной системы: `thread(fn, args)`, `thread_join`, `async fn();`, мьютексы `mutex_create/lock/unlock` и разделяемая среда `GrassSharedEnv` с защитой от гонок.

Native OS threads, async dispatch, thread synchronization joins, mutex primitives, and shared race-protected memory.

п. 13

Официальное расширение для Visual Studio Code

Official Visual Studio Code Extension

Complete

Собранный установочный пакет `.vsix` (`grassgreen-4.0.0.vsix`): полная TextMate подсветка, иконки для файлов `.grass` и `.gdb`, сниппеты кода и поддержка горячих клавиш сборки.

Packaged `grassgreen-4.0.0.vsix` extension bundle containing full language grammar, icons, and snippets.

п. 14

Представление значений через NaN-Boxing

Value Representation via NaN-Boxing

Complete

Упаковка чисел, булевых флагов, указателей и дескрипторов в плоский 64-битный формат IEEE 754 (ровно 8 байт). Двукратное сокращение нагрузки на L1-кэш процессора и ускорение вызовов функций.

Strict 8-byte IEEE 754 representation for numbers, booleans, pointers, and objects with 2x cache efficiency.

п. 15

Аллокатор памяти: Arena Allocator

Arena Allocator (Bump Pointer)

Complete

Линейное выделение непрерывного пула памяти под AST и байт-код со сдвигом указателя. Мгновенное освобождение памяти модулей в O(1) без фрагментации, вызовов malloc/free и утечек ресурсов.

Continuous memory pool allocation with pointer increments and zero-fragmentation O(1) deallocation.

п. 16

Диспетчеризация через Labels-as-Values

Labels-as-Values Dispatch (Computed Goto)

Complete

Механизм `goto *dispatch_table[op]` для прямого прыжка из конца текущей инструкции в начало следующей. Процессор использует таблицу предсказания переходов без задержек центрального цикла.

Direct `goto *dispatch_table[op]` jumps eliminating central branch-prediction bottlenecks in VM execution.

п. 17

Оптимизация расположения структур: C-ABI Data Alignment

C-ABI Data Alignment

Complete

Выравнивание полей структур по естественным границам адресов (1, 4, 8 байт). 100% совместимость компоновки памяти структур с нативными драйверами и кодом на C/C++.

Exact 1, 4, and 8-byte field alignment conforming strictly to native C-ABI struct layouts.

п. 18

Аппаратный доступ к физической памяти: MMIO и `volatile`

Hardware MMIO & Volatile Access

Complete

Прямое чтение и запись физических адресов памяти (`mmio_read8..64`, `mmio_write8..64`), порты x86 (`inb`/`outb`), квалификатор `volatile` и барьеры сериализации памяти mfence/lfence/sfence.

Direct MMIO read/writes, x86 Port I/O instructions, `volatile` variable qualifiers, and hardware memory fence instructions.

п. 19

Ребрендинг экосистемы: `G&G`

Ecosystem Rebranding: `G&G`

Complete

Официальное сокращённое наименование проекта: **G&G** (*Grass & Green*). Бинарник компилятора в терминале — **`grg`** (в среде Windows — `grg.exe` / `grassc.exe`).

Unified ecosystem naming: G&G with primary compiler CLI binary command `grg`.

п. 20

Флаги командной строки компилятора `grg`

Compiler CLI Flags

Complete

Богатый набор управляющих опций компилятора: `-o <имя>`, `-c` (только байт-код), `-emit-exe` (автономный бинарник), `-O0..-O3`, `--dump-ast`, `-S` (дизассемблер), `--time` (замер миллисекунд этапов), `--freestanding`, `--ru` / `--en`.

Comprehensive flags: `-o`, `-c`, `-emit-exe`, `-O0..-O3`, `--dump-ast`, `-S`, `--time`, `--freestanding`, `--ru`/`--en`.

Documentation Hub

Официальная документация

Official Documentation

Полные справочные руководства по каждой подсистеме языка в репозитории проекта.

Comprehensive guides and specifications across all subsystems in the GitHub repository.

Спецификация ядра (docs/main.md)

Core Language Spec (docs/main.md)

Синтаксис функций `take`, поток вывода `gout`, ввод `gin`, структуры `struct`, динамические массивы и системные вызовы.

Function declarations, `gout`/`gin` stream mechanics, `struct` types, arrays, and Win32 system interop.

Открыть спецификацию Open Specification

Справочник библиотек (docs/library.md)

Library Directory (docs/library.md)

Полный перечень всех 18 стандартных библиотек с директивами подключения `!name!` и описанием назначения каждого модуля.

Complete breakdown of all 18 standard modules, import syntax directives, and capabilities.

Открыть справочник Open Directory

Win32 GUI & 2D Движок

Win32 GUI & 2D Graphics

Документация оконного интерфейса `!interface!` и графического холста `!2DGraphics!` с двойной буферизацией и коллизиями.

Guides for native window rendering, controls, double-buffered canvases, and 2D collision detection.

Открыть руководство GUI Open GUI Guide