fabrilis/docs/DEPENDENCIES.md
loki5512344 79928b645b
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

5.1 KiB
Raw Blame History

Зависимости

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