Erweiterungen & Ökosystem

Small World verfolgt eine strikte Modularisierungsstrategie (siehe ADR 0014, ADR 0018, ADR 0021 und ADR 0022).

Die Kern-Engine (@small-world/engine) bleibt ultraleicht und enthält ausschließlich universelle Kernsysteme: Mathematik, Szenengraph, Kameras, Renderer, Passes, Standard-Shader, Kern-Primitive und Basiskollisionen. Alle domänenspezifischen, fortgeschrittenen oder datenintensiven Funktionen werden als Ökosystem-Pakete über NPM Workspaces bereitgestellt.

Verfügbare Erweiterungspakete

Paket	Verzeichnis	Beschreibung
@small-world/vfx-extras	packages/vfx-extras/	GPU-instanziierte Partikelsysteme, ParticleMeshRenderer, 10 universelle Kraftfeld-Affektoren, Akkretionsscheiben-Simulation und thermodynamische Strahlungskühlung.
@small-world/geometry-extras	packages/geometry-extras/	Exotische und prozedurale 3D-Geometrien: Supershapes, Torus-Knoten, Lathe-Drehkörper, Platonische Körper, Voronoi-Zellen, Marching Cubes und parametrische Flächen.
@small-world/physics-extras	packages/physics-extras/	Höherstufige physikalische Zerstörungs- und Fraktursysteme (Voronoi-Bruch mit konvexen Kollisionskörpern).
@small-world/gltf-extensions	packages/gltf-extensions/	Datenebenen-Dekoder und Kompressions-Plugins für glTF 2.0 (KHR_draco_mesh_compression, KHR_texture_basisu).

---

Architektur-Prinzipien

graph TD
    Engine["@small-world/engine (Kern)"]
    VFX["@small-world/vfx-extras"] --> Engine
    Geom["@small-world/geometry-extras"] --> Engine
    Phys["@small-world/physics-extras"] --> Engine
    Phys -.-> Geom
    GLTF["@small-world/gltf-extensions"] --> Engine
    Apps["Apps & Spiele (The Whisper, YAD, Showcases)"] --> Engine
    Apps --> VFX
    Apps --> Geom
    Apps --> Phys
    Apps --> GLTF

1. Einseitige Abhängigkeiten: Erweiterungspakete hängen von @small-world/engine ab — der Kern kennt seine Erweiterungen niemals direkt.
2. Azyklische Kopplung: Erweiterungspakete dürfen untereinander interagieren (z. B. physics-extras nutzt geometry-extras), sofern keine zirkulären Abhängigkeiten entstehen.
3. Zero Tree-Shaking Waste: Entwickler binden nur die Erweiterungen ein, die ihre Anwendung tatsächlich benötigt.