fabrilis/docs/DEPENDENCIES.md
loki5512344 878d144b77 Initial commit: Fabrilis docs, rules and deterministic core
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.
2026-11-16 23:06:29 +01:00

56 lines
5.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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