# Islumina

> Small, independent TypeScript modules for browser and game runtimes. Packages are currently aligned at 0.5.9 and licensed under MIT.

## Start here

- [AI Quick Start](https://islumina.org/en/guides/ai-quick-start/): package selection, PixiJS path, and validation checklist
- [Sprite Playground](https://islumina.org/playground/): hosted read-only editor demo and local MCP handoff
- [Ecosystem](https://islumina.org/en/guides/ecosystem/): package roles and common combinations
- [Full AI context](https://islumina.org/llms-full.txt): standalone ecosystem reference
- [GitHub organisation](https://github.com/islumina): authoritative source repositories

## Packages

- [aiecsjs](https://github.com/islumina/aiecsjs): archetype ECS with TypedArray SoA
- [aispritejs](https://github.com/islumina/aispritejs): input-driven sprite state graph and optional PixiJS v8 adapter
- [aiaudiojs](https://github.com/islumina/aiaudiojs): Howler-based audio lifecycle wrapper
- [aieventjs](https://github.com/islumina/aieventjs): typed event emitter
- [aifsmjs](https://github.com/islumina/aifsmjs): deterministic finite-state machine
- [aiquadtreejs](https://github.com/islumina/aiquadtreejs): 2D quadtree broadphase
- [aipooljs](https://github.com/islumina/aipooljs): fixed-size object pool
- [aibridgejs](https://github.com/islumina/aibridgejs): transport-agnostic cross-context bridge
- [AI Sprite Studio](https://github.com/islumina/aisprite-studio): sprite atlas generation, QA, packing, ai*js web editor, and local MCP agent bridge

## Package-level AI context

Each package repository contains `llms.txt` and generated `llms-full.txt`. Read package `exports` before selecting an import subpath. Treat AI Sprite Studio's existing generated artwork as failed test material; require deterministic and visual QA before packing.