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.
56 lines
5.1 KiB
Markdown
56 lines
5.1 KiB
Markdown
# Зависимости
|
||
|
||
Правило: пишем своё, где это разумно; берём готовое, только когда оно отлично
|
||
работает и писать самим слишком дорого. Каждая внешняя зависимость обосновывается
|
||
записью в 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).
|