Package Overview
Islumina is not a monolithic framework. It provides a set of minimal, single-responsibility packages that you can combine freely. Every package is published independently with zero cross-package dependencies.
All packages: v0.5.5, MIT licensed.
Core Packages
Section titled “Core Packages”| Package | Role | Size | NPM |
|---|---|---|---|
| aiecsjs | Archetype ECS with TypedArray SoA | ~4 KB gzip | npmjs |
| aispritejs | Input-driven 2D sprite animation state machine | ~2 KB gzip | npmjs |
| aiaudiojs | Thin Web Audio shell over Howler.js | ~2 KB gzip | npmjs |
| aieventjs | Typed event emitter | ~1 KB gzip | npmjs |
| aifsmjs | Deterministic FSM, definition–implementation split | ~3 KB gzip | npmjs |
| aiquadtreejs | 2D quadtree collision broadphase | ~2 KB gzip | npmjs |
| aipooljs | Fixed-size object pool | ~1 KB gzip | npmjs |
| aibridgejs | Transport-agnostic cross-context bridge | ~2 KB gzip | npmjs |
Common Combinations
Section titled “Common Combinations”Full game stack
Section titled “Full game stack”For PixiJS games — ECS for data, FSM for state, Pool for object recycling, Quadtree for collision broadphase, Sprite for animation, Audio for sound.
aiecsjs + aifsmjs + aipooljs + aiquadtreejs + aispritejs + aiaudiojsLightweight interactive app
Section titled “Lightweight interactive app”No full ECS needed — just event communication and state management:
aieventjs + aifsmjsHybrid app (Flutter WebView)
Section titled “Hybrid app (Flutter WebView)”Web logic with cross-context communication:
aibridgejs + aifsmjsSource Code
Section titled “Source Code”All packages are maintained independently under the islumina GitHub organisation.
Packages are in active development (v0.5.x). The v1.0 API freeze is planned after major game demo validation.