Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
5.1 KiB
Зависимости
Правило: пишем своё, где это разумно; берём готовое, только когда оно отлично работает и писать самим слишком дорого. Каждая внешняя зависимость обосновывается записью в DECISIONS.md.
Замеры (16.11.2026, версии по умолчанию из crates.io)
«Crate'ов на Linux» — зависимости, которые реально собираются на Linux. Размер исходников и строки считаны для всех платформ (включая Windows и macOS), поэтому завышены; для оценки скорости сборки смотри число crate'ов.
| Библиотека | Crate'ов на Linux | Исходники, МБ | Строк Rust | Решение |
|---|---|---|---|---|
libm |
1 | 0.6 | 20 тыс. | берём (детерминированная математика) |
serde |
7 | 4.2 | 119 тыс. | берём (форматы) |
ron |
10 | 5.2 | 149 тыс. | берём (форматы сцен и конструкций) |
rayon |
6 | 1.8 | 53 тыс. | берём позже (развёртки, Monte Carlo) |
fontdue |
8 | 3.2 | 86 тыс. | берём для текста в своём UI; позже можно заменить своим растеризатором |
rhai |
25 | 25.6 | 669 тыс. | берём (скрипты) |
rapier3d-f64 |
46 | 55.0 | 1757 тыс. | временно, пока не напишем свой backend (D3); вариант на f64 + enhanced-determinism |
wgpu |
61 | 209.1 | 4163 тыс. | берём; самый тяжёлый, см. ниже |
winit |
72 | 234.7 | 4163 тыс. | берём (окна и ввод на трёх ОС писать самим слишком дорого) |
gltf |
37 | 19.3 | 541 тыс. | не берём сейчас: свой минимальный читатель; возьмём, только если glTF станет обязательным |
nalgebra |
19 | 36.4 | 1289 тыс. | не берём в симуляции (свой core::vec) |
glam |
1 | 6.4 | 250 тыс. | не берём в симуляции (свой core::vec) |
egui |
54 | 35.1 | 944 тыс. | не берём (D20) |
proptest |
26 | 54.5 | 1441 тыс. | dev-зависимость, берём для property-тестов (D26) |
criterion |
51 | 166.7 | 1643 тыс. | dev-зависимость, берём для бенчмарков (D26) |
ash (Vulkan напрямую) |
3 | 5.0 | 131 тыс. | запасной вариант вместо wgpu |
Что пишем сами
Планировщик, единицы, векторная математика, эмулятор CPU и SoC, аналоговый решатель, балки и FEM, тепло, аэродинамика, мышцы, мир, рендер-слой, UI, импорт STL/OBJ и минимальный glTF, физический backend (после старта на Rapier).
Тяжёлые, которые оставляем пока
wgpu(61 crate): самый тяжёлый, но скрыт за crate'омrender. Если время сборки или размер начнут мешать, переходим наash(3 crate'а): придётся написать свой менеджер памяти, swapchain и синхронизацию, а шейдеры компилировать заранее. Минусash: macOS только через MoltenVK.winit(72 crate'а): окна на Wayland, X11, Windows и macOS вручную — слишком большая работа без пользы для цели проекта.rapier3d-f64: вариант Rapier наf64(тот же набор crate'ов) плюс фичаenhanced-determinism; нужен для быстрого старта и не вносит границуf32. Авторитетные результаты со временем считает свой backend.rhai: заменить своим языком возможно, но это отдельный большой проект.
UI
Свой UI на нашем рендере (D20, D34): immediate-mode список команд, панели, текст,
кнопки, ползунки, графики, дерево деталей, таблица свойств, окно 3D-вида, потом
редактор схем и жгутов. Растеризация шрифта через fontdue; shaping/IME для
текстовых полей — кандидаты cosmic-text/Parley, решение на M10 (UI.md).
Сначала оверлей отладки (M4), полноценный редактор в M10.
Отвергнуты: egui (не нравится), iced (тяжёлый), slint (лицензия GPL/коммерческая
несовместима с MIT), xilem (молодой). Blueprint ShapeUI — источник контрактов,
не фундамент (UI.md).