# declarative-hex-worlds

> Deterministic KayKit Medieval Hexagon gameboard runtime for TypeScript games — Koota ECS state, declarative recipe → blueprint → scenario compilation, seeded RNG determinism, first-class React + Three.js bindings, and a CLI that bootstraps FREE (GitHub) or EXTRA (itch.io zip) KayKit asset packs into the consumer app.

Install with `npm install declarative-hex-worlds` (react, react-dom, three, koota are peer dependencies).
Assets are bootstrapped, not bundled: run `npx declarative-hex-worlds bootstrap` to mirror the KayKit gltf tree into your app, then resolve URLs against it at game init.
The FREE edition manifest ships with the package (`declarative-hex-worlds/manifest/free`); the premium EXTRA edition (paid itch.io pack) is ingested from a user-supplied zip via `bootstrap --source zip --zip <path>` — edition auto-detected — and validated by the same manifest schema.
All randomness flows through seeded RNG — identical seeds produce identical worlds.

## Documentation Sets

- [Abridged documentation](https://jonbogaty.com/declarative-hex-worlds/llms-small.txt): a compact version of the documentation for declarative-hex-worlds, with non-essential content removed
- [Complete documentation](https://jonbogaty.com/declarative-hex-worlds/llms-full.txt): the full documentation for declarative-hex-worlds

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation